TypeScript Other
Switch branches/tags
Nothing to show
Clone or download
Latest commit c1d6893 Aug 13, 2018
Failed to load latest commit information.
.vscode Adds support for scheduling a task when in sanbox mode May 23, 2018
docs Docs and tests Aug 6, 2018
public Improve the index Apr 26, 2018
scripts Upate staging May 25, 2018
source Update danger Aug 13, 2018
.babelrc More docs Feb 18, 2018
.dockerignore Add logging Mar 26, 2017
.env.sample Get a bit closer to fixing the runTasks issue Jun 8, 2018
.gitignore More deploy faff Apr 21, 2018
.node-version Pin node version. Apr 14, 2018
.prettierignore Initial version of relative imports for Dangerfiles Aug 5, 2018
.travis.yml Another try at stamping a commit Jun 4, 2018
CHANGELOG.md Stop danger bugging me Aug 6, 2018
Dockerfile Fix docker builds Apr 21, 2018
Dockerfile.runner Remove the sha stamping Jun 4, 2018
LICENSE Update license year Dec 29, 2017
README.md README udpates Jun 23, 2018
VISION.md Update the vision file now that it's basically feature complete Jul 22, 2018
app.json Update default values for `app.json` for Heroku Jan 13, 2018
dangerfile.lite.ts Stop danger bugging me Aug 6, 2018
docker-compose.yml Add support for a Peril user ID, remove ENV var things which aren't used Apr 11, 2017
jsconfig.json init Dec 17, 2016
now.staging.json Adds apollo engine to the graphql instance May 26, 2018
package.json Update danger Aug 13, 2018
peril-settings-json.schema Adds a JSON schema May 21, 2018
tsconfig.json Adds the ability to send a recorded webhook through the peril pipeline May 6, 2018
tslint.json Initial implementation for recording all webhooks for 5m Apr 28, 2018
wallaby.js Docs and tests Aug 6, 2018
yarn.lock Update danger Aug 13, 2018


per·il ˈperəl noun

  1. serious and immediate danger. "their family was in peril".

Peril is a tool that takes GitHub webhooks, and makes it easy to build one-off actions. It does this by having a per-account settings JSON, that connects JavaScript files to events from webhooks. So, for example, you can write a rule which runs when closing an issue in GitHub that looks for associated Jira tickets and resolves them. Peril provides no implicit actions like that, it instead offers a JavaScript runtime environment optimised to this domain so you can make actions to fit your needs.

Want to understand what the plan is? Consult the VISION.md

Peril uses Danger JS under the hood, Danger is a tool built for adding extra tests inside Pull Requests that can work at a different level of abstraction to unit and integration tests. For example, you could write tests which:

  • 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

... and any other rules specific to your team's culture and needs.

I want to run Peril for my org

OK, I made a quick tutorial for running a private Peril against your org.

I want to hack on Peril!

Ace, great, cool. So, it's a bit of a process. I'm not sure if this will get easier in time. It's a complex app. You can find out more here

How does Peril work?

There are some key files where the magic happens:

This is an reasonably tested project, there's a lot in places where the code isn't going to change much now so they're slowly getting covered.