document autofix

README.md

@@ -84,6 +84,9 @@ cmd = ["iprecommit-no-forbidden-strings", "--commits"]
 - `name` and `cmd` are the only supported keys for `pre_push` checks.
 - `cmd` is passed a list of Git revisions to be pushed to the remote repository.
 
+### Autofix
+If the top-level `autofix` option is set to `true` in the TOML file, then when a fixable check fails, `iprecommit run` will automatically invoke `iprecommit fix`, and then re-run `iprecommit run` after. This is useful if you have, e.g., auto-formatting checks that can fix themselves without human intervention.
+
 ## Custom commands
 These commands are designed to be used with `iprecommit`, but they can also be used independently.
 

iprecommit/main.py

@@ -222,6 +222,10 @@ def replace_file(path: Path, new_contents: str) -> None:
 # This file configures Git hooks for the project.
 # Documentation: https://github.com/iafisher/iprecommit
 
+# Set 'autofix' to 'true' to automatically run 'iprecommit fix' if a fixable
+# check fails.
+autofix = false
+
 [[pre_commit]]
 name = "NoForbiddenStrings"
 cmd = ["iprecommit-no-forbidden-strings", "--paths"]