New upgrade command to autofix lint rules

ghstack-source-id: ec39278a75ea8af6f783503c46b37dd5260288f9
Pull Request resolved: #349

Author: amyreese

docs/guide/commands.rst

@@ -109,6 +109,19 @@ Example:
     OK
 
 
+``upgrade``
+^^^^^^^^^^^
+
+Upgrade lint rules or client code to the latest version of Fixit.
+Automatically applies fixes from all upgrade rules in :mod:`fixit.upgrade`.
+
+Shortcut for ``fixit --rules fixit.upgrade fix --automatic <path>``
+
+.. code:: console
+
+    $ fixit upgrade [PATH ...]
+
+
 ``debug``
 ^^^^^^^^^
 

src/fixit/cli.py

@@ -15,7 +15,7 @@
 
 from .api import fixit_paths, print_result
 from .config import collect_rules, generate_config, parse_rule
-from .ftypes import Config, Options, Tags
+from .ftypes import Config, Options, QualifiedRule, Tags
 from .rule import LintRule
 from .testing import generate_lint_rule_test_cases
 from .util import capture
@@ -218,6 +218,21 @@ def test(ctx: click.Context, rules: Sequence[str]):
         ctx.exit(1)
 
 
+@main.command()
+@click.pass_context
+@click.argument("paths", nargs=-1, type=click.Path(path_type=Path))
+def upgrade(ctx: click.Context, paths: Sequence[Path]):
+    """
+    upgrade lint rules and apply deprecation fixes
+
+    roughly equivalent to `fixit --rules fixit.upgrade fix --automatic`
+    """
+    options: Options = ctx.obj
+    options.rules = (QualifiedRule("fixit.upgrade"),)
+
+    ctx.invoke(fix, paths=paths, interactive=False)
+
+
 @main.command()
 @click.pass_context
 @click.argument("paths", nargs=-1, type=click.Path(exists=True, path_type=Path))