Skip to content

sanitizers/chronographer-github-app

Repository files navigation

chronographer-github-app

Your severe chronographer who is watching you record all the news to change note files!

Configuring the installed app

Here's an example configuration file that a repository where Chronographer is installed can use optionally, to set certain aspects of this GitHub App's behavior:

# .github/chronographer.yml
---

action-hints:
  # check-title-prefix: chng  # default: `{{ branch-protection-check-name }}: `
  external-docs-url: https://pip.pypa.io/how-to-changelog
  inline-markdown: >
    Check out https://pip.pypa.io/how-to-changelog

branch-protection-check-name: Timeline protection

enforce-name:
  suffix: .rst  # can be empty or `.md` too

exclude:
  bots:
  - dependabot-preview
  - dependabot
  - patchback
  humans:
  - pyup-bot

labels:
  fragment-provided: change note detected  # default: `bot:chronographer:provided`, disable with `~`
  skip-changelog: skip news  # default: `bot:chronographer:skip`

paths:  # relative modified file paths that do or don't need changelog mention
  exclude: []
  include: []
  towncrier-config-filename: ~  # default: `~`, which means checking both

...

Running the app

Local development

  1. Copy a dotenv config template: cp -v .env{.example,}
  2. Change GITHUB_APP_IDENTIFIER value and GITHUB_PRIVATE_KEY contents
    • You should be able to inline the key using a trick like this:
    GITHUB_PRIVATE_KEY_PATH=~/Downloads/your-app-slug.2019-03-24.private-key.pem
    cat $GITHUB_PRIVATE_KEY_PATH | python3.7 -c 'import sys; inline_private_key=r"\n".join(map(str.strip, sys.stdin.readlines())); print(f"GITHUB_PRIVATE_KEY='"'"'{inline_private_key}'"'"'", end="")' >> .env
  3. python3.7 -m chronographer

Known issues/limitations

About

Your severe chronographer robot who is watching you record all the news to change note files!

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

 

Packages

No packages published

Contributors 3

  •  
  •  
  •