Add fmt command

.github/workflows/test.yml

@@ -43,9 +43,11 @@ jobs:
         pip install -e .
         pip install -e ./backend
 
-    - if: ${{ !startsWith(matrix.python-version, 'pypy') }}
-      name: Lint
-      run: hatch run lint:all
+    - name: Run static analysis
+      run: hatch fmt --check
+
+    - name: Check types
+      run: hatch run types:check
 
     - name: Run tests
       run: hatch run full

README.md

@@ -22,9 +22,10 @@ Hatch is a modern, extensible Python project manager.
 - Standardized [build system](https://hatch.pypa.io/latest/build/#packaging-ecosystem) with reproducible builds by default
 - Robust [environment management](https://hatch.pypa.io/latest/environment/) with support for custom scripts
 - Configurable [Python distribution management](https://hatch.pypa.io/dev/cli/reference/#hatch-python)
+- [Static analysis](https://hatch.pypa.io/dev/config/static-analysis/) with sane defaults
 - Easy [publishing](https://hatch.pypa.io/latest/publish/) to PyPI or other indexes
 - [Version](https://hatch.pypa.io/latest/version/) management
-- Configurable [project generation](https://hatch.pypa.io/latest/config/project-templates/) with sane defaults
+- Best practice [project generation](https://hatch.pypa.io/latest/config/project-templates/)
 - Responsive [CLI](https://hatch.pypa.io/latest/cli/about/), ~2-3x [faster](https://github.com/pypa/hatch/blob/hatch-v1.5.0/.github/workflows/test.yml#L76-L108) than equivalent tools
 
 ## Documentation

docs/config/static-analysis.md

@@ -0,0 +1,83 @@
+# Static analysis configuration
+
+-----
+
+Static analysis performed by the [`fmt`](../cli/reference.md#hatch-fmt) command is backed entirely by [Ruff](https://github.com/astral-sh/ruff).
+
+Hatch provides default settings that user configuration can [extend](#extending-config).
+
+## Extending config
+
+When defining your configuration, be sure to use options that are prefixed by `extend-` such as [`extend-select`](https://docs.astral.sh/ruff/settings/#extend-select), for example:
+
+=== ":octicons-file-code-16: pyproject.toml"
+
+    ```toml
+    [tool.ruff.lint]
+    preview = true
+    extend-select = ["C901"]
+
+    [tool.ruff.lint.extend-per-file-ignores]
+    "docs/.hooks/*" = ["INP001", "T201"]
+
+    [tool.ruff.lint.isort]
+    known-first-party = ["foo", "bar"]
+
+    [tool.ruff.format]
+    preview = true
+    quote-style = "single"
+    ```
+
+=== ":octicons-file-code-16: ruff.toml"
+
+    ```toml
+    [lint]
+    preview = true
+    extend-select = ["C901"]
+
+    [lint.extend-per-file-ignores]
+    "docs/.hooks/*" = ["INP001", "T201"]
+
+    [lint.isort]
+    known-first-party = ["foo", "bar"]
+
+    [format]
+    preview = true
+    quote-style = "single"
+    ```
+
+!!! note
+    When not [persisting config](#persistent-config), there is no need to explicitly [extend](https://docs.astral.sh/ruff/settings/#extend) the defaults as Hatch automatically handles that internally.
+
+## Persistent config
+
+If you want to store the default configuration in the project, set an explicit path like so:
+
+```toml config-example
+[tool.hatch.format]
+config-path = "ruff_defaults.toml"
+```
+
+Then instruct Ruff to consider your configuration as an extension of the default file:
+
+=== ":octicons-file-code-16: pyproject.toml"
+
+    ```toml
+    [tool.ruff]
+    extend = "ruff_defaults.toml"
+    ```
+
+=== ":octicons-file-code-16: ruff.toml"
+
+    ```toml
+    extend = "ruff_defaults.toml"
+    ```
+
+Anytime you wish to update the defaults (such as when upgrading Hatch), you must run the [`fmt`](../cli/reference.md#hatch-fmt) command once with the `--sync` flag e.g.:
+
+```
+hatch fmt --check --sync
+```
+
+!!! tip
+    This is the recommended approach since it allows other tools like IDEs to use the default configuration.

docs/history/hatch.md

@@ -19,11 +19,11 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 - Support Python 3.12
 - Add installers and standalone binaries
 - Add the ability to manage Python installations
+- Add `fmt` command
 - The `virtual` environment type can now automatically download requested versions of Python that are not installed
 - Add `dependency_hash` method to the `environment` interface
 - The state of installed dependencies for environments is saved as metadata so if dependency definitions have not changed then no checking is performed, which can be computationally expensive
 - The `build` command now supports backends other than Hatchling
-- For new project templates rely only on `requires-python` for configuring the target version Ruff and Black
 - The default is now `__TOKEN__` when prompting for a username for the `publish` command
 - Bump the minimum supported version of Hatchling to 1.17.1
 - Bump the minimum supported version of `click` to 8.0.6

docs/index.md

@@ -18,9 +18,10 @@ Hatch is a modern, extensible Python project manager.
 - Standardized [build system](build.md#packaging-ecosystem) with reproducible builds by default
 - Robust [environment management](environment.md) with support for custom scripts
 - Configurable [Python distribution management](cli/reference.md#hatch-python)
+- [Static analysis](config/static-analysis.md) with sane defaults
 - Easy [publishing](publish.md) to PyPI or other indexes
 - [Version management](version.md)
-- Configurable [project generation](config/project-templates.md) with sane defaults
+- Best practice [project generation](config/project-templates.md)
 - Responsive [CLI](cli/about.md), ~2-3x [faster](https://github.com/pypa/hatch/blob/hatch-v1.5.0/.github/workflows/test.yml#L76-L108) than equivalent tools
 
 ## License

hatch.toml

@@ -44,26 +44,12 @@ report-uncovered-html = "coverage html --skip-covered --skip-empty"
 generate-summary = "python scripts/generate_coverage_summary.py"
 write-summary-report = "python scripts/write_coverage_summary_report.py"
 
-[envs.lint]
-detached = true
+[envs.types]
 dependencies = [
   "mypy>=1.0.0",
-  "ruff==0.1.6",
-]
-[envs.lint.scripts]
-typing = "mypy --install-types --non-interactive {args:backend/src/hatchling src/hatch tests}"
-style = [
-  "ruff check {args:.}",
-  "ruff format --check --diff {args:.}",
-]
-fmt = [
-  "ruff check --fix {args:.}",
-  "ruff format {args:.}",
-]
-all = [
-  "style",
-  "typing",
 ]
+[envs.types.scripts]
+check = "mypy --install-types --non-interactive {args:backend/src/hatchling src/hatch tests}"
 
 [envs.docs]
 dependencies = [
@@ -126,16 +112,22 @@ version = "cd backend && hatch version {args}"
 detached = true
 dependencies = [
   "httpx",
+  "ruff",
 ]
 [envs.upkeep.scripts]
 update-hatch = [
   "update-distributions",
+  "update-ruff",
 ]
 update-hatchling = [
   "update-licenses",
 ]
 update-distributions = "python scripts/update_distributions.py"
 update-licenses = "python backend/scripts/update_licenses.py"
+update-ruff = [
+  "python -m pip install --disable-pip-version-check --upgrade ruff",
+  "python scripts/update_ruff.py",
+]
 
 [envs.release]
 detached = true

mkdocs.yml

@@ -69,6 +69,7 @@ nav:
     - Environments:
       - Overview: config/environment/overview.md
       - Advanced: config/environment/advanced.md
+    - Static analysis: config/static-analysis.md
     - Context formatting: config/context.md
     - Project templates: config/project-templates.md
     - Hatch: config/hatch.md