Skip to content

Automatically fix all software bugs.

License

Notifications You must be signed in to change notification settings

autofix-bot/autofix

 
 

Repository files navigation

Autofix

Gitpod Ready-to-Code NPM version NPM dependencies

Automatically fix all software bugs.

Examples

Automatically fix bugs in the current directory:

autofix

Preview all the commands this would run, but don't actually do anything:

autofix --dry

Autofix bugs, commit fixes into separate branches, push branches to a GitHub remote:

autofix --branches --push=myremote

Autofix bugs in a GitHub repository:

autofix https://github.com/nodejs/node

Autofix bugs in a GitHub repository, commit fixes, and automatically send pull requests (requires hub):

autofix https://github.com/nodejs/node --pull-request

Try it online

Open in Gitpod

Install

With npm do:

npm install -g autofix

Or run it directly via npx:

npx autofix

Command line options

autofix (DIRECTORY|REPOSITORY) [OPTIONS]
  • DIRECTORY: Run autofix in a particular directory (defaults to .).
  • REPOSITORY: Clone a Git repository, then run autofix in it.

OPTIONS:

  • --dry: Simulate without actually running any fix commands
  • --branches: Commit fixes of different types into different branches (e.g. autofix-codespell)
  • --tiers=0,1,2: Choose which types of bugs should be autofixed (see details about tiers below)
  • --verbose: Log additional information to the console (e.g. for troubleshooting autofix bugs)
  • --push=REMOTE: Push fixes to a given GitHub remote (e.g. your GitHub username)
  • --pull-request: Automatically open pull requests with pushed commits (requires hub, implies --push=origin if unspecified)
  • --branch-suffix=SUFFIX: Add a common suffix to generated branch names (i.e. autofix-codespell-SUFFIX)
  • --signoff: Use Git's --signoff (or -s) feature when creating commits
  • --circle-ci: Run this autofix weekly on CircleCI (adds a .circleci/config.yml file)

Types of bugs that can be fixed

Tier 0 (no rework needed):

  • Remove trailing whitespace (uses git, xargs and sed)
  • Update pinned pyenv tool versions in Dockerfiles (requires pyenv)
  • Update pinned nvm tool versions in Dockerfiles (requires nvm)
  • Update pinned sdkman tool versions in Dockerfiles (requires sdkman)
  • Update pinned rr versions in Dockerfiles
  • Update some pinned Go module versions in Dockerfiles
  • Update Git submodules

Tier 1 (some rework might be needed):

  • Fix typos & spelling mistakes (requires codespell)

Tier 2 (experimental, use with caution):

Tier 3 (you probably don't want to run these):

  • TODO

About

Automatically fix all software bugs.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 99.6%
  • Dockerfile 0.4%