Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/danger/danger-js

⚠️ Stop saying "you forgot to …" in code review
https://github.com/danger/danger-js

ci circle code-review danger danger-js github-actions jenkins travis

Last synced: 14 days ago
JSON representation

⚠️ Stop saying "you forgot to …" in code review

Awesome Lists containing this project

README 

        


  

  Formalize your Pull Request etiquette.






    What is Danger JS? •

    Vision •

    Helping Out •

    Plugin Development




## What is Danger JS?



Danger runs after your CI, automating your team's conventions surrounding code review.



This provides another logical step in your process, through which Danger can help lint your rote tasks in daily code

review.



You can use Danger to codify your team's norms, leaving humans to think about harder problems.



Danger JS works with GitHub, BitBucket Server, BitBucket Cloud for code review, then with: Travis CI, GitLab CI,

Semaphore, Circle CI, GitHub Actions, Jenkins, Docker Cloud, Bamboo, Bitrise, surf-build, Codeship, Drone, Buildkite,

Nevercode, buddybuild, Buddy.works, TeamCity, Visual Studio Team Services, Screwdriver, Concourse, Netlify, CodeBuild,

Codefresh, AppCenter, BitBucket Pipelines, Cirrus CI, Codemagic or Xcode Cloud.



[![npm](https://img.shields.io/npm/v/danger.svg)](https://www.npmjs.com/package/danger)

[![Build Status](https://travis-ci.org/danger/danger-js.svg?branch=main)](https://travis-ci.org/danger/danger-js)

[![Build Status](https://ci.appveyor.com/api/projects/status/ep5hgeox3lbc5c7f?svg=true)](https://ci.appveyor.com/project/orta/danger-js/branch/main)



## For example?



You can:



- Enforce CHANGELOGs

- Enforce links to Trello/JIRA in PR/MR bodies

- Enforce using descriptive labels

- Look out for common anti-patterns

- Highlight interesting build artifacts

- Give warnings when specific files change



Danger provides the glue to let _you_ build out the rules specific to your team's culture, offering useful metadata and

a comprehensive plugin system to share common issues.



## Getting Started



Alright. So, actually, you may be in the wrong place. From here on in, this README is going to be for people who are

interested in working on and improving on Danger JS.



We keep all of the end-user documentation at .



Some quick links to get you started:



- [Getting Started](http://danger.systems/js/guides/getting_started.html)

- [Guides Index](http://danger.systems/js/guides.html)

- [DSL Reference](http://danger.systems/js/reference.html)



## This thing is broken, I should help improve it!



Awesommmmee. Everything you need is down below. You can also refer to [CONTRIBUTING](CONTRIBUTING.md) file where you'll

find the same information listed below.



```sh

git clone https://github.com/danger/danger-js.git

cd danger-js



# if you don't have yarn installed

npm install -g yarn



yarn install

```



You can then verify your install by running the tests, and the linters:



```sh

yarn test

yarn lint

```



The fixers for both tslint and prettier will be applied when you commit, and on a push your code will be verified that

it compiles.



You can run your dev copy of danger against a PR by running:



```sh

yarn build; node --inspect distribution/commands/danger-pr.js https://github.com/danger/danger-js/pull/817

```



### How does Danger JS work?



Check the [architecture doc](https://github.com/danger/danger-js/blob/main/docs/architecture.md).



### What is the TODO?



Check the issues, I try and keep my short term perspective there. Long term is in the [VISION.md](VISION.md).



### Releasing a new version of Danger



Following [this commit](https://github.com/danger/danger-js/commit/a26ac3b3bd4f002acd37f6a363c8e74c9d5039ab) as a model:



- Checkout the `main` branch. Ensure your working tree is clean, and make sure you have the latest changes by running

  `git pull; yarn`.

- Publish - `npm run release -- patch --ci`.

- This will trigger a CI run which updates homebrew for the native builds



:ship:



## License, Contributor's Guidelines and Code of Conduct



We try to keep as much discussion as possible in GitHub issues, but also have a pretty inactive Slack --- if you'd like

an invite, ping [@Orta](https://twitter.com/orta/) a DM on Twitter with your email. It's mostly interesting if you want

to stay on top of Danger without all the emails from GitHub.



> This project is open source under the MIT license, which means you have full access to the source code and can modify

> it to fit your own needs but don't have access to deploy.

>

> This project subscribes to the [Moya Contributors Guidelines](https://github.com/Moya/contributors) which TLDR: means

> we give out push access easily and often.

>

> Contributors subscribe to the [Contributor Code of Conduct](http://contributor-covenant.org/version/1/3/0/) based on

> the [Contributor Covenant](http://contributor-covenant.org) version 1.3.0.



[emiss]: https://github.com/artsy/emission/blob/master/dangerfile.ts

[danger-js]: https://github.com/danger/danger-js/blob/main/dangerfile.ts

[meta]: https://github.com/artsy/metaphysics/blob/master/dangerfile.js

[fbj]: https://github.com/facebook/jest/blob/master/dangerfile.js

[sc]: https://github.com/styled-components/styled-components/blob/master/dangerfile.js

[rxjs]: https://github.com/ReactiveX/rxjs/blob/master/dangerfile.js

[setup]: http://danger.systems/guides/getting_started.html#creating-a-bot-account-for-danger-to-use

[jest]: https://github.com/facebook/jest