1HATCH-CLEAN(1) User Commands HATCH-CLEAN(1)
2
3
4
6 hatch clean – Removes a project’s build artifacts
7
9 hatch clean [OPTIONS] [PACKAGE]
10
12 Removes a project’s build artifacts.
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 All *.pyc/*.pyd/*.pyo files and __pycache__ directories will be re‐
26 moved. Additionally, the following patterns will be removed from the
27 root of the path: .cache, .coverage, .eggs, .tox, build, dist, and
28 *.egg-info.
29
30 If the path was derived from the optional package argument, the pattern
31 *.egg-info will not be applied so as to not break that installation.
32
34 -l, --local
35 Shortcut to select the only available local (editable) package.
36 If there are multiple, an error will be raised.
37
38 -p, --path TEXT
39 A relative or absolute path to a project.
40
41 -c, --compiled-only
42 Removes only .pyc files.
43
44 -nd, --no-detect
45 Disables the detection of a project’s dedicated virtual env. By
46 default, it will not be considered.
47
48 -v, --verbose
49 Shows removed paths.
50
51 -h, --help
52 Show a help message and exit.
53
55 hatch(1)
56
57 hatch-build(1), hatch-conda(1), hatch-config(1), hatch-env(1),
58 hatch-grow(1), hatch-init(1), hatch-install(1), hatch-new(1), hatch-py‐
59 path(1), hatch-python(1), hatch-release(1), hatch-shed(1),
60 hatch-shell(1), hatch-test(1), hatch-uninstall(1), hatch-update(1)
61
62
63
64 Feburary 2022 HATCH-CLEAN(1)