1HATCH-BUILD(1) User Commands HATCH-BUILD(1)
2
3
4
6 hatch build – Builds a project
7
9 hatch build [OPTIONS] [PACKAGE]
10
12 Builds a project, producing a source distribution and a wheel.
13
14 The path to the project is derived in the following order:
15
16 1. The optional argument, which should be the name of a package
17 that was installed via hatch install -l or pip install -e.
18
19 2. The --local flag.
20
21 3. The option --path, which can be a relative or absolute path.
22
23 4. The current directory.
24
25 The path must contain a setup.py file.
26
28 -l, --local
29 Shortcut to select the only available local (editable) package.
30 If there are multiple, an error will be raised.
31
32 -p, --path TEXT
33 A relative or absolute path to a project.
34
35 -py, --python TEXT
36 The named Python path to use. This overrides --pypath.
37
38 -pp, --pypath TEXT
39 An absolute path to a Python executable.
40
41 -u, --universal
42 Indicates compatibility with both Python 2 and 3.
43
44 -n, --name TEXT
45 Forces a particular platform name, e.g. linux_x86_64.
46
47 -d, --build-dir TEXT
48 A relative or absolute path to the desired build directory.
49
50 -c, --clean
51 Removes build artifacts before building.
52
53 -v, --verbose
54 Increases verbosity.
55
56 -h, --help
57 Show a help message and exit.
58
60 hatch(1)
61
62 hatch-clean(1), hatch-conda(1), hatch-config(1), hatch-env(1),
63 hatch-grow(1), hatch-init(1), hatch-install(1), hatch-new(1), hatch-py‐
64 path(1), hatch-python(1), hatch-release(1), hatch-shed(1),
65 hatch-shell(1), hatch-test(1), hatch-uninstall(1), hatch-update(1)
66
67
68
69 Feburary 2022 HATCH-BUILD(1)