Skip to content

Project templates


You can control how new projects are created by the new command using Hatch's config file.

Author

[template]
name = "..."
email = "..."

Licenses

[template.licenses]
headers = true
default = [
  "MIT",
]

The list of licenses should be composed of SPDX identifiers. If multiple licenses are specified, then they will be placed in a LICENSES directory.

Options

Tests

This adds a tests directory with environments for testing and linting.

[template.plugins.default]
tests = true

CI

This adds a GitHub Actions workflow that runs tests on all platforms using modern versions of Python.

[template.plugins.default]
ci = false

src layout

See this blog post.

[template.plugins.default]
src-layout = true

Feature flags

Command line interface

The --cli flag adds a CLI backed by Click that can also be invoked with python -m <PKG_NAME>.