js-org / js.org-cleanup

The scripts behind the annual js.org cleanup process

Home Page:https://js.org

Repository from Github https://github.comjs-org/js.org-cleanupRepository from Github https://github.comjs-org/js.org-cleanup

js.org Donate

Cleanup Scripts

These are the scripts behind the annual js.org cleanup process.

CLI

These scripts operate as a small CLI tool, by running node index.js.

There are four options within the CLI:

  • --perfect : Generates a perfectly formatted and sorted cnames_active file
  • --main-issue : Initiates the annual cleanup by creating the main cleanup issue
  • --main-pr <issueNumber> : Completes the annual cleanup by parsing issue and creating PR
  • --validate <filePath> [--fix] : Validates a given cnames_active file for perfect formatting

When using --perfect, --main-issue, or --main-pr, you will need to have a config.json file created in the root of the repository following config.example.json.

When using --main-pr, if the token does not have write access to the repository, it will automatically create a fork of the repository and make the pull request against that fork. If the account already has a fork of the repository, you will need to ensure that the default branch of the fork is up to date with the upstream repository (or delete the fork) before running the command.

If you are using --validate, then no config is needed as this operates against a given local file path rather than using the GitHub API. This option can also be passed a --fix flag after the file path to automatically fix any violations.

Examples

Generated Main Issue

js-org-cleanup/simulated-js.org#46

Generated Contact Issue

js-org-cleanup/simulated-automatic-contact#12

Generated Pull Request

js-org-cleanup/simulated-js.org#47

About

The scripts behind the annual js.org cleanup process

https://js.org

License:GNU Affero General Public License v3.0


Languages

Language:JavaScript 100.0%