PR#1: Update to 1.0.0 - rpms/hatch - src.fedoraproject.org

.gitignore

file modified

+4

		`@@ -3,3 +3,7 @@`
		`/hatch-0.23.0.tar.gz`
		`/hatch-0.23.1.tar.gz`
		`/hatch-804d5fd902809bae19e72a50917bd90ab032e174.tar.gz`
		`+ /hatch-1.0.0rc12.tar.gz`
		`+ /hatch-1.0.0rc13.tar.gz`
		`+ /hatch-1.0.0rc16.tar.gz`
		`+ /hatch-1.0.0.tar.gz`

extract-hatchling-environments

file added

+125

		`@@ -0,0 +1,125 @@`
		`+ #!/usr/bin/python3`
		`+`
		`+ from argparse import ArgumentDefaultsHelpFormatter, ArgumentParser, FileType`
		`+ from os import devnull`
		`+ from pathlib import Path`
		`+ from sys import exit, stderr`
		`+`
		`+ from tomli import load`
		`+`
		`+`
		`+ def parse_args():`
		`+ p = ArgumentParser(`
		`+ description=("Write hatchling environments to requirements files"),`
		`+ formatter_class=ArgumentDefaultsHelpFormatter,`
		`+ epilog="""The output directory will files of the form env.{foo,bar}.txt`
		`+ for any environments (foo, bar) defined in envs in hatch.toml, if`
		`+ present, or in tool.hatch.envs in pyproject.toml.""",`
		`+ )`
		`+ p.add_argument(`
		`+ "--pyproject",`
		`+ metavar="FILE",`
		`+ type=FileType("rb"),`
		`+ default=Path("pyproject.toml"),`
		`+ help="Path to pyproject.toml file that uses hatchling",`
		`+ )`
		`+ p.add_argument(`
		`+ "--hatch",`
		`+ metavar="FILE",`
		`+ type=FileType("rb"),`
		`+ default=Path("hatch.toml"),`
		`+ help="Path to optional hatch.toml file",`
		`+ )`
		`+ p.add_argument(`
		`+ "--dir",`
		`+ metavar="DIR",`
		`+ type=Path,`
		`+ default="_req",`
		`+ help="Directory to contain requirements files",`
		`+ )`
		`+ p.add_argument(`
		`+ "--verbose",`
		`+ "-v",`
		`+ action="store_const",`
		`+ const=stderr,`
		`+ default=Path(devnull),`
		`+ help="Print details about what is happening",`
		`+ )`
		`+ args = p.parse_args()`
		`+ # We don’t use a with statement to close this file, because if it is`
		`+ # stderr, we don’t want to close it before reporting a traceback.`
		`+ args.verbose = ensure_open(args.verbose, "w")`
		`+ return args`
		`+`
		`+`
		`+ def ensure_open(path_or_file, mode):`
		`+ if isinstance(path_or_file, Path):`
		`+ path_or_file = path_or_file.open(mode)`
		`+ return path_or_file`
		`+`
		`+`
		`+ def dump(output, dependencies, v):`
		`+ with output.open("w") as requirements:`
		`+ requirements.writelines(`
		`+ f"{dependency}\n" for dependency in dependencies`
		`+ )`
		`+ n = len(dependencies)`
		`+ print(`
		`+ f"Wrote {output.name} with {n} dependenc{'y' if n == 1 else 'ies'}",`
		`+ file=v,`
		`+ )`
		`+`
		`+`
		`+ def resolve_environment(env_name, all_envs, project):`
		`+ # https://ofek.dev/hatch/latest/config/environment/`
		`+ env = all_envs[env_name]`
		`+ try:`
		`+ # If "dependencies" is present, it overrides templates anyway.`
		`+ deps = env["dependencies"]`
		`+ except KeyError:`
		`+ if not env.get("detached", False):`
		`+ # Inherit from templates`
		`+ template = env.get("template", "default")`
		`+ if template != env_name:`
		`+ deps = resolve_environment(template, all_envs, project)`
		`+ for extra in env.get("features", []):`
		`+ deps.extend(project["optional-dependencies"][extra])`
		`+ deps.extend(env.get("extra-dependencies", []))`
		`+ return deps`
		`+`
		`+`
		`+ def main():`
		`+ args = parse_args()`
		`+ v = args.verbose`
		`+`
		`+ with ensure_open(args.pyproject, "rb") as pyproject_file:`
		`+ pyproject = load(pyproject_file)`
		`+ try:`
		`+ with ensure_open(args.hatch, "rb") as hatch_file:`
		`+ hatch = load(hatch_file)`
		`+ except FileNotFoundError:`
		`+ hatch = {}`
		`+`
		`+ backend = pyproject.get("build-system", {}).get("build-backend")`
		`+ if backend != "hatchling.build":`
		`+ return "build-system.build-backend is not hatchling.build"`
		`+ try:`
		`+ project = pyproject["project"]`
		`+ except KeyError:`
		`+ return "no “project” section is present"`
		`+`
		`+ args.dir.mkdir(parents=True, exist_ok=True)`
		`+ print(f"Created {args.dir.resolve()}", file=v)`
		`+`
		`+ try:`
		`+ envs = hatch["envs"]`
		`+ except KeyError:`
		`+ envs = pyproject.get("tool", {}).get("hatch", {}).get("envs", {})`
		`+ for name in envs:`
		`+ requirements = args.dir / f"env.{name}.txt"`
		`+ dependencies = resolve_environment(name, envs, project)`
		`+ dump(requirements, dependencies, v)`
		`+`
		`+`
		`+ if __name__ == "__main__":`
		`+ exit(main())`

hatch-build.1

file modified

+52 -70

		`@@ -1,88 +1,70 @@`
		`- .TH HATCH\-BUILD "1" "Feburary 2022" "" "User Commands"`
		`+ .TH HATCH\-BUILD "1" "March 2022" "" "User Commands"`
		`.SH NAME`
		`.B hatch\ build`
		`- \(en Builds a project`
		`+ \(en Build a project`
		`.SH SYNOPSIS`
		`.B hatch\ build`
		`.RI [ OPTIONS ]`
		`- .RI [ PACKAGE ]`
		`- .SH DESCRIPTION`
		`- .P`
		`- Builds a project, producing a source distribution and a wheel.`
		`- .P`
		`- The path to the project is derived in the following order:`
		`- .RS +7n`
		`- .IP 1. +3n`
		`- The optional argument, which should be`
		`- the name of a package that was installed via`
		`- .B hatch install \-l`
		`- or`
		`- .B pip install \-e\fR.`
		`- .IP 2. +3n`
		`- The`
		`- .B \-\-local`
		`- flag.`
		`- .IP 3. +3n`
		`- The option`
		`- .BR \-\-path ,`
		`- which can be a relative or absolute path.`
		`- .IP 4. +3n`
		`- The current directory.`
		`- .RE`
		`- .P`
		`- The path must contain a`
		`- .B setup.py`
		`- file.`
		`+ .RI [ LOCATION ]`
		`.SH OPTIONS`
		`.TP`
		`- .B \-l\fR, \fB\-\-local`
		`- Shortcut to select the only available local (editable) package.`
		`- If there are multiple, an error will be raised.`
		`+ .B \-t\fR, \fB\-\-target\ \fITEXT`
		`+ The target to build,`
		`+ overriding project defaults.`
		`+ This may be selected multiple times`
		`+ e.g. \fB\-t\ sdist \-t\ wheel\fR`
		`.TP`
		`- .B \-p\fR, \fB\-\-path\ \fITEXT`
		`- A relative or absolute path to a project.`
		`+ .B \-\-hooks\-only`
		`+ Whether or not to only execute build hooks`
		`+ [env var:`
		`+ .BR HATCH_BUILD_HOOKS_ONLY ]`
		`.TP`
		`- .B \-py\fR, \fB\-\-python\ \fITEXT`
		`- The named Python path to use. This overrides`
		`- .BR \-\-pypath .`
		`+ .B \-\-no\-hooks`
		`+ Whether or not to disable build hooks`
		`+ [env var:`
		`+ .BR HATCH_BUILD_NO_HOOKS ]`
		`.TP`
		`- .B \-pp\fR, \fB\-\-pypath\ \fITEXT`
		`- An absolute path to a Python executable.`
		`+ .B \-\-ext`
		`+ Whether or not to only execute build hooks for`
		`+ distributing binary Python packages, such as compiling extensions.`
		`+ Equivalent to`
		`+ .B \-\-hooks\-only\ \-t\ wheel`
		`.TP`
		`- .B \-u\fR, \fB\-\-universal`
		`- Indicates compatibility with both Python 2 and 3.`
		`+ .B \-c\fR, \fB\-\-clean`
		`+ Whether or not existing artifacts should first be removed`
		`+ [env var:`
		`+ .BR HATCH_BUILD_CLEAN ]`
		`.TP`
		`- .B \-n\fR, \fB\-\-name\ \fITEXT`
		`- Forces a particular platform name, e.g. \fBlinux_x86_64\fR.`
		`+ .B \-\-clean\-hooks\-after`
		`+ Whether or not build hook artifacts should be removed`
		`+ after each build`
		`+ [env var:`
		`+ .BR HATCH_BUILD_CLEAN_HOOKS_AFTER ]`
		`.TP`
		`- .B \-d\fR, \fB\-\-build-dir\ \fITEXT`
		`- A relative or absolute path to the desired build directory.`
		`+ .B \-h\fR, \fB\-\-help`
		`+ Show a help message and exit`
		`+ .SH ENVIRONMENT`
		`.TP`
		`- .B \-c\fR, \fB\-\-clean`
		`- Removes build artifacts before building.`
		`+ .B HATCH_BUILD_HOOKS_ONLY`
		`+ Whether or not to only execute build hooks`
		`+ [option:`
		`+ .BR \-\-hooks\-only ]`
		`.TP`
		`- .B \-v\fR, \fB\-\-verbose`
		`- Increases verbosity.`
		`+ .B HATCH_BUILD_NO_HOOKS`
		`+ Whether or not to disable build hooks`
		`+ [option:`
		`+ .BR \-\-no\-hooks ]`
		`.TP`
		`- .B \-h\fR, \fB\-\-help`
		`- Show a help message and exit.`
		`+ .B HATCH_BUILD_CLEAN`
		`+ Whether or not existing artifacts should first be removed`
		`+ [option:`
		`+ .BR \-c ,`
		`+ .BR \-\-clean ]`
		`+ .TP`
		`+ .B HATCH_BUILD_CLEAN_HOOKS_AFTER`
		`+ Whether or not build hook artifacts should be removed`
		`+ after each build`
		`+ [option:`
		`+ .BR \-\-clean\-hooks\-after ]`
		`.SH "SEE ALSO"`
		`.BR hatch (1)`
		`- .P`
		`- .\" .BR hatch\-build (1),`
		`- .BR hatch\-clean (1),`
		`- .BR hatch\-conda (1),`
		`- .BR hatch\-config (1),`
		`- .BR hatch\-env (1),`
		`- .BR hatch\-grow (1),`
		`- .BR hatch\-init (1),`
		`- .BR hatch\-install (1),`
		`- .BR hatch\-new (1),`
		`- .BR hatch\-pypath (1),`
		`- .BR hatch\-python (1),`
		`- .BR hatch\-release (1),`
		`- .BR hatch\-shed (1),`
		`- .BR hatch\-shell (1),`
		`- .BR hatch\-test (1),`
		`- .BR hatch\-uninstall (1),`
		`- .BR hatch\-update (1)`

hatch-clean.1

file modified

+33 -82

		`@@ -1,96 +1,47 @@`
		`- .TH HATCH\-CLEAN "1" "Feburary 2022" "" "User Commands"`
		`+ .TH HATCH\-CLEAN "1" "March 2022" "" "User Commands"`
		`.SH NAME`
		`.B hatch\ clean`
		`- \(en Removes a project\(cqs build artifacts`
		`+ \(en Remove build artifacts`
		`.SH SYNOPSIS`
		`.B hatch\ clean`
		`.RI [ OPTIONS ]`
		`- .RI [ PACKAGE ]`
		`- .SH DESCRIPTION`
		`- .P`
		`- Removes a project\(cqs build artifacts.`
		`- .P`
		`- The path to the project is derived in the following order:`
		`- .RS +7n`
		`- .IP 1. +3n`
		`- The optional argument, which should be`
		`- the name of a package that was installed via`
		`- .B hatch install \-l`
		`- or`
		`- .B pip install \-e\fR.`
		`- .IP 2. +3n`
		`- The`
		`- .B \-\-local`
		`- flag.`
		`- .IP 3. +3n`
		`- The option`
		`- .BR \-\-path ,`
		`- which can be a relative or absolute path.`
		`- .IP 4. +3n`
		`- The current directory.`
		`- .RE`
		`- .P`
		`- All`
		`- .BR .pyc / .pyd / *.pyo`
		`- files and`
		`- .B __pycache__`
		`- directories will be removed.`
		`- Additionally, the following patterns will be removed`
		`- from the root of the path:`
		`- .BR .cache ,`
		`- .BR .coverage ,`
		`- .BR .eggs ,`
		`- .BR .tox ,`
		`- .BR build ,`
		`- .BR dist ,`
		`- and`
		`- .BR *.egg-info .`
		`- .P`
		`- If the path was derived from the optional package argument,`
		`- the pattern`
		`- .B *.egg-info`
		`- will not be applied so as to not break that installation.`
		`+ .RI [ LOCATION ]`
		`.SH OPTIONS`
		`.TP`
		`- .B \-l\fR, \fB\-\-local`
		`- Shortcut to select the only available local (editable) package.`
		`- If there are multiple, an error will be raised.`
		`+ .B \-t\fR, \fB\-\-target\ \fITEXT`
		`+ The target with which to remove artifacts,`
		`+ overriding project defaults.`
		`+ This may be selected multiple times`
		`+ e.g. \fB\-t\ sdist \-t\ wheel\fR`
		`.TP`
		`- .B \-p\fR, \fB\-\-path\ \fITEXT`
		`- A relative or absolute path to a project.`
		`+ .B \-\-hooks\-only`
		`+ Whether or not to only remove artifacts from build hooks`
		`+ [env var:`
		`+ .BR HATCH_BUILD_HOOKS_ONLY ]`
		`.TP`
		`- .B \-c\fR, \fB\-\-compiled\-only`
		`- Removes only`
		`- .B .pyc`
		`- files.`
		`+ .B \-\-no\-hooks`
		`+ Whether or not to ignore artifacts from build hooks`
		`+ [env var:`
		`+ .BR HATCH_BUILD_NO_HOOKS ]`
		`.TP`
		`- .B \-nd\fR, \fB\-\-no\-detect`
		`- Disables the detection of a project\(cqs`
		`- dedicated virtual env.`
		`- By default, it will not be considered.`
		`- .TP`
		`- .B \-v\fR, \fB\-\-verbose`
		`- Shows removed paths.`
		`+ .B \-\-ext`
		`+ Whether or not to only remove artifacts from build hooks for`
		`+ distributing binary Python packages, such as compiled extensions.`
		`+ Equivalent to`
		`+ .B \-\-hooks\-only\ \-t\ wheel`
		`.TP`
		`.B \-h\fR, \fB\-\-help`
		`- Show a help message and exit.`
		`+ Show a help message and exit`
		`+ .SH ENVIRONMENT`
		`+ .TP`
		`+ .B HATCH_BUILD_HOOKS_ONLY`
		`+ Whether or not to only remove artifacts from build hooks`
		`+ [option:`
		`+ .BR \-\-hooks\-only ]`
		`+ .TP`
		`+ .B HATCH_BUILD_NO_HOOKS`
		`+ Whether or not to ignore artifacts from build hooks`
		`+ [option:`
		`+ .BR \-\-no\-hooks ]`
		`.SH "SEE ALSO"`
		`.BR hatch (1)`
		`- .P`
		`- .BR hatch\-build (1),`
		`- .\" .BR hatch\-clean (1),`
		`- .BR hatch\-conda (1),`
		`- .BR hatch\-config (1),`
		`- .BR hatch\-env (1),`
		`- .BR hatch\-grow (1),`
		`- .BR hatch\-init (1),`
		`- .BR hatch\-install (1),`
		`- .BR hatch\-new (1),`
		`- .BR hatch\-pypath (1),`
		`- .BR hatch\-python (1),`
		`- .BR hatch\-release (1),`
		`- .BR hatch\-shed (1),`
		`- .BR hatch\-shell (1),`
		`- .BR hatch\-test (1),`
		`- .BR hatch\-uninstall (1),`
		`- .BR hatch\-update (1)`

hatch-conda.1

file removed

-53

		`@@ -1,53 +0,0 @@`
		`- .TH HATCH\-CONDA "1" "Feburary 2022" "" "User Commands"`
		`- .SH NAME`
		`- .B hatch\ conda`
		`- \(en Installs Miniconda`
		`- .SH SYNOPSIS`
		`- .B hatch\ conda`
		`- .RI [ OPTIONS ]`
		`- .I LOCATION`
		`- .SH DESCRIPTION`
		`- .P`
		`- Installs`
		`- .UR https://conda.io/docs/glossary.html#miniconda-glossary`
		`- Miniconda`
		`- .UE`
		`- .SH OPTIONS`
		`- .TP`
		`- .B \-f\fR, \fB\-\-force`
		`- Proceed through errors and even if Conda is already installed.`
		`- .TP`
		`- .B \-\-head\fR\ / \fB\-\-tail`
		`- Adds Conda to the head or tail (default) of the user`
		`- .BR PATH .`
		`- .TP`
		`- .B \-\-install\-only`
		`- Does not modify the user`
		`- .BR PATH .`
		`- .TP`
		`- .B \-\-show`
		`- Does nothing but show what would be added to the user`
		`- .BR PATH .`
		`- .TP`
		`- .B \-h\fR, \fB\-\-help`
		`- Show a help message and exit.`
		`- .SH "SEE ALSO"`
		`- .BR hatch (1)`
		`- .P`
		`- .BR hatch\-build (1),`
		`- .BR hatch\-clean (1),`
		`- .\" .BR hatch\-conda (1),`
		`- .BR hatch\-config (1),`
		`- .BR hatch\-env (1),`
		`- .BR hatch\-grow (1),`
		`- .BR hatch\-init (1),`
		`- .BR hatch\-install (1),`
		`- .BR hatch\-new (1),`
		`- .BR hatch\-pypath (1),`
		`- .BR hatch\-python (1),`
		`- .BR hatch\-release (1),`
		`- .BR hatch\-shed (1),`
		`- .BR hatch\-shell (1),`
		`- .BR hatch\-test (1),`
		`- .BR hatch\-uninstall (1),`
		`- .BR hatch\-update (1)`

hatch-config-explore.1

file added

+14

		`@@ -0,0 +1,14 @@`
		`+ .TH HATCH\-CONFIG\-EXPLORE "1" "March 2022" "" "User Commands"`
		`+ .SH NAME`
		`+ .B hatch\ config\ explore`
		`+ \(en Open the config location in your file manager`
		`+ .SH SYNOPSIS`
		`+ .B hatch\ config\ explore`
		`+ .RI [ OPTIONS ]`
		`+ .SH OPTIONS`
		`+ .TP`
		`+ .B \-h\fR, \fB\-\-help`
		`+ Show a help message and exit`
		`+ .SH "SEE ALSO"`
		`+ .BR hatch (1),`
		`+ .BR hatch\-config (1)`

hatch-config-find.1

file added

+17

		`@@ -0,0 +1,17 @@`
		`+ .TH HATCH\-CONFIG\-FIND "1" "March 2022" "" "User Commands"`
		`+ .SH NAME`
		`+ .B hatch\ config\ find`
		`+ \(en Show the location of the config file`
		`+ .SH SYNOPSIS`
		`+ .B hatch\ config\ find`
		`+ .RI [ OPTIONS ]`
		`+ .SH OPTIONS`
		`+ .TP`
		`+ .B \-c\fR, \fB\-\-copy`
		`+ Copy the path to the config file to the clipboard`
		`+ .TP`
		`+ .B \-h\fR, \fB\-\-help`
		`+ Show a help message and exit`
		`+ .SH "SEE ALSO"`
		`+ .BR hatch (1),`
		`+ .BR hatch\-config (1)`

hatch-config-restore.1

file added

+14

		`@@ -0,0 +1,14 @@`
		`+ .TH HATCH\-CONFIG\-RESTORE "1" "March 2022" "" "User Commands"`
		`+ .SH NAME`
		`+ .B hatch\ config\ restore`
		`+ \(en Restore the config file to default settings`
		`+ .SH SYNOPSIS`
		`+ .B hatch\ config\ restore`
		`+ .RI [ OPTIONS ]`
		`+ .SH OPTIONS`
		`+ .TP`
		`+ .B \-h\fR, \fB\-\-help`
		`+ Show a help message and exit`
		`+ .SH "SEE ALSO"`
		`+ .BR hatch (1),`
		`+ .BR hatch\-config (1)`

hatch-config-set.1

file added

+20

		`@@ -0,0 +1,20 @@`
		`+ .TH HATCH\-CONFIG\-SET "1" "March 2022" "" "User Commands"`
		`+ .SH NAME`
		`+ .B hatch\ config\ set`
		`+ \(en Assign values to config file entries`
		`+ .SH SYNOPSIS`
		`+ .B hatch\ config\ set`
		`+ .RI [ OPTIONS ]`
		`+ .I KEY`
		`+ .RI [ VALUE ]`
		`+ .SH DESCRIPTION`
		`+ Assign values to config file entries.`
		`+ If the value is omitted, you will be`
		`+ prompted, with the input hidden if it is sensitive.`
		`+ .SH OPTIONS`
		`+ .TP`
		`+ .B \-h\fR, \fB\-\-help`
		`+ Show a help message and exit`
		`+ .SH "SEE ALSO"`
		`+ .BR hatch (1),`
		`+ .BR hatch\-config (1)`

hatch-config-show.1

file added

+17

		`@@ -0,0 +1,17 @@`
		`+ .TH HATCH\-CONFIG\-SHOW "1" "March 2022" "" "User Commands"`
		`+ .SH NAME`
		`+ .B hatch\ config\ show`
		`+ \(en Show the contents of the config file`
		`+ .SH SYNOPSIS`
		`+ .B hatch\ config\ show`
		`+ .RI [ OPTIONS ]`
		`+ .SH OPTIONS`
		`+ .TP`
		`+ .B \-a\fR, \fB\-\-all`
		`+ Do not scrub secret fields`
		`+ .TP`
		`+ .B \-h\fR, \fB\-\-help`
		`+ Show a help message and exit`
		`+ .SH "SEE ALSO"`
		`+ .BR hatch (1),`
		`+ .BR hatch\-config (1)`

hatch-config-update.1

file added

+14

		`@@ -0,0 +1,14 @@`
		`+ .TH HATCH\-CONFIG\-UPDATE "1" "March 2022" "" "User Commands"`
		`+ .SH NAME`
		`+ .B hatch\ config\ update`
		`+ \(en Update the config file with any new fields`
		`+ .SH SYNOPSIS`
		`+ .B hatch\ config\ update`
		`+ .RI [ OPTIONS ]`
		`+ .SH OPTIONS`
		`+ .TP`
		`+ .B \-h\fR, \fB\-\-help`
		`+ Show a help message and exit`
		`+ .SH "SEE ALSO"`
		`+ .BR hatch (1),`
		`+ .BR hatch\-config (1)`

hatch-config.1

file modified

+47 -36

		`@@ -1,48 +1,59 @@`
		`- .TH HATCH\-CONFIG "1" "Feburary 2022" "" "User Commands"`
		`+ .TH HATCH\-CONFIG "1" "March 2022" "" "User Commands"`
		`.SH NAME`
		`.B hatch\ config`
		`- \(en Locates, updates, or restores the config file`
		`+ \(en Manage the config file`
		`.SH SYNOPSIS`
		`.B hatch\ config`
		`.RI [ OPTIONS ]`
		`- .SH DESCRIPTION`
		`- .P`
		`- Locates, updates, or restores the config file.`
		`+ .I COMMAND`
		`+ .RI [ ARGS ]...`
		`.SH OPTIONS`
		`.TP`
		`- .B \-u\fR, \fB\-\-update`
		`- Updates the config file with any new fields.`
		`+ .B \-h\fR, \fB\-\-help`
		`+ Show a help message and exit`
		`+ .SS "COMMANDS"`
		`.TP`
		`- .B \-\-restore`
		`- Restores the config file to default settings.`
		`+ .B explore`
		`+ Open the config location in your file manager`
		`+ .IP`
		`+ See`
		`+ .BR hatch\-config\-explore (1).`
		`.TP`
		`- .B \-h\fR, \fB\-\-help`
		`- Show a help message and exit.`
		`- .SH EXAMPLES`
		`- .P`
		`- .in +7n`
		`- .EX`
		`- .B $\ hatch\ config`
		`- .B Settings location: /home/ofek/.local/share/hatch/settings.json`
		`- .EE`
		`- .in`
		`+ .B find`
		`+ Show the location of the config file`
		`+ .IP`
		`+ See`
		`+ .BR hatch\-config\-find (1).`
		`+ .TP`
		`+ .B restore`
		`+ Restore the config file to default settings`
		`+ .IP`
		`+ See`
		`+ .BR hatch\-config\-restore (1).`
		`+ .TP`
		`+ .B set`
		`+ Assign values to config file entries`
		`+ .IP`
		`+ See`
		`+ .BR hatch\-config\-set (1).`
		`+ .TP`
		`+ .B show`
		`+ Show the contents of the config file`
		`+ .IP`
		`+ See`
		`+ .BR hatch\-config\-show (1).`
		`+ .TP`
		`+ .B update`
		`+ Update the config file with any new fields`
		`+ .IP`
		`+ See`
		`+ .BR hatch\-config\-update (1).`
		`.SH "SEE ALSO"`
		`.BR hatch (1)`
		`.P`
		`- .BR hatch\-build (1),`
		`- .BR hatch\-clean (1),`
		`- .BR hatch\-conda (1),`
		`- .\" .BR hatch\-config (1),`
		`- .BR hatch\-env (1),`
		`- .BR hatch\-grow (1),`
		`- .BR hatch\-init (1),`
		`- .BR hatch\-install (1),`
		`- .BR hatch\-new (1),`
		`- .BR hatch\-pypath (1),`
		`- .BR hatch\-python (1),`
		`- .BR hatch\-release (1),`
		`- .BR hatch\-shed (1),`
		`- .BR hatch\-shell (1),`
		`- .BR hatch\-test (1),`
		`- .BR hatch\-uninstall (1),`
		`- .BR hatch\-update (1)`
		`+ .BR hatch\-config\-explore (1),`
		`+ .BR hatch\-config\-find (1),`
		`+ .BR hatch\-config\-restore (1),`
		`+ .BR hatch\-config\-set (1),`
		`+ .BR hatch\-config\-show (1),`
		`+ .BR hatch\-config\-update (1)`

hatch-dep-hash.1

file added

+20

		`@@ -0,0 +1,20 @@`
		`+ .TH HATCH\-DEP\-HASH "1" "March 2022" "" "User Commands"`
		`+ .SH NAME`
		`+ .B hatch\ dep\ hash`
		`+ \(en Output a hash of the currently defined dependencies`
		`+ .SH SYNOPSIS`
		`+ .B hatch\ dep\ hash`
		`+ .RI [ OPTIONS ]`
		`+ .SH OPTIONS`
		`+ .TP`
		`+ .B \-p\fR, \fB\-\-project\-only`
		`+ Whether or not to exclude environment dependencies`
		`+ .TP`
		`+ .B \-e\fR, \fB\-\-env\-only`
		`+ Whether or not to exclude project dependencies`
		`+ .TP`
		`+ .B \-h\fR, \fB\-\-help`
		`+ Show a help message and exit`
		`+ .SH "SEE ALSO"`
		`+ .BR hatch (1),`
		`+ .BR hatch\-dep (1)`

hatch-dep-show-table.1

file added

+27

		`@@ -0,0 +1,27 @@`
		`+ .TH HATCH\-DEP\-SHOW\-TABLE "1" "March 2022" "" "User Commands"`
		`+ .SH NAME`
		`+ .B hatch\ dep\ show\ table`
		`+ \(en Enumerate dependencies in a tabular format`
		`+ .SH SYNOPSIS`
		`+ .B hatch\ dep\ show\ table`
		`+ .RI [ OPTIONS ]`
		`+ .SH OPTIONS`
		`+ .TP`
		`+ .B \-p\fR, \fB\-\-project\-only`
		`+ Whether or not to exclude environment dependencies`
		`+ .TP`
		`+ .B \-e\fR, \fB\-\-env\-only`
		`+ Whether or not to exclude project dependencies`
		`+ .TP`
		`+ .B \-l\fR, \fB\-\-lines`
		`+ Whether or not to show lines between table rows`
		`+ .TP`
		`+ .B \-\-ascii`
		`+ Whether or not to only use ASCII characters`
		`+ .TP`
		`+ .B \-h\fR, \fB\-\-help`
		`+ Show a help message and exit`
		`+ .SH "SEE ALSO"`
		`+ .BR hatch (1),`
		`+ .BR hatch\-dep (1),`
		`+ .BR hatch\-dep\-show (1)`

hatch-dep-show.1

file added

+22

		`@@ -0,0 +1,22 @@`
		`+ .TH HATCH\-DEP\-SHOW "1" "March 2022" "" "User Commands"`
		`+ .SH NAME`
		`+ .B hatch\ dep\ show`
		`+ \(en Display dependencies in various formats`
		`+ .SH SYNOPSIS`
		`+ .B hatch\ dep\ show`
		`+ .RI [ OPTIONS ]`
		`+ .I COMMAND`
		`+ .RI [ ARGS ]...`
		`+ .SH OPTIONS`
		`+ .TP`
		`+ .B \-h\fR, \fB\-\-help`
		`+ Show a help message and exit`
		`+ .SS "COMMANDS"`
		`+ .TP`
		`+ .B table`
		`+ Enumerate dependencies in a tabular format`
		`+ .SH "SEE ALSO"`
		`+ .BR hatch (1),`
		`+ .BR hatch\-dep (1)`
		`+ .P`
		`+ .BR hatch\-dep\-show\-table (1)`

hatch-dep.1

file added

+31

		`@@ -0,0 +1,31 @@`
		`+ .TH HATCH\-DEP "1" "March 2022" "" "User Commands"`
		`+ .SH NAME`
		`+ .B hatch\ dep`
		`+ \(en Manage environment dependencies`
		`+ .SH SYNOPSIS`
		`+ .B hatch\ dep`
		`+ .RI [ OPTIONS ]`
		`+ .I COMMAND`
		`+ .RI [ ARGS ]...`
		`+ .SH OPTIONS`
		`+ .TP`
		`+ .B \-h\fR, \fB\-\-help`
		`+ Show a help message and exit`
		`+ .SS "COMMANDS"`
		`+ .TP`
		`+ .B hash`
		`+ Output a hash of the currently defined dependencies`
		`+ .IP`
		`+ See`
		`+ .BR hatch\-dep\-hash (1).`
		`+ .TP`
		`+ .B show`
		`+ Display dependencies in various formats`
		`+ .IP`
		`+ See`
		`+ .BR hatch\-dep\-show (1).`
		`+ .SH "SEE ALSO"`
		`+ .BR hatch (1)`
		`+ .P`
		`+ .BR hatch\-dep\-hash (1),`
		`+ .BR hatch\-dep\-show (1)`

hatch-env-create.1

file added

+15

		`@@ -0,0 +1,15 @@`
		`+ .TH HATCH\-ENV\-CREATE "1" "March 2022" "" "User Commands"`
		`+ .SH NAME`
		`+ .B hatch\ env\ create`
		`+ \(en Create environments`
		`+ .SH SYNOPSIS`
		`+ .B hatch\ env\ create`
		`+ .RI [ OPTIONS ]`
		`+ .SH OPTIONS`
		`+ .TP`
		`+ .B \-h\fR, \fB\-\-help`
		`+ Show a help message and exit`
		`+ .SH "SEE ALSO"`
		`+ .BR hatch (1)`
		`+ .P`
		`+ .BR hatch\-env (1)`

hatch-env-find.1

file added

+14

		`@@ -0,0 +1,14 @@`
		`+ .TH HATCH\-ENV\-FIND "1" "March 2022" "" "User Commands"`
		`+ .SH NAME`
		`+ .B hatch\ env\ find`
		`+ \(en Locate environments`
		`+ .SH SYNOPSIS`
		`+ .B hatch\ env\ find`
		`+ .RI [ OPTIONS ]`
		`+ .SH OPTIONS`
		`+ .TP`
		`+ .B \-h\fR, \fB\-\-help`
		`+ Show a help message and exit`
		`+ .SH "SEE ALSO"`
		`+ .BR hatch (1),`
		`+ .BR hatch\-env (1)`

hatch-env-prune.1

file added

+14

		`@@ -0,0 +1,14 @@`
		`+ .TH HATCH\-ENV\-PRUNE "1" "March 2022" "" "User Commands"`
		`+ .SH NAME`
		`+ .B hatch\ env\ prune`
		`+ \(en Remove all environments`
		`+ .SH SYNOPSIS`
		`+ .B hatch\ env\ prune`
		`+ .RI [ OPTIONS ]`
		`+ .SH OPTIONS`
		`+ .TP`
		`+ .B \-h\fR, \fB\-\-help`
		`+ Show a help message and exit`
		`+ .SH "SEE ALSO"`
		`+ .BR hatch (1),`
		`+ .BR hatch\-env (1)`

hatch-env-remove.1

file added

+14

		`@@ -0,0 +1,14 @@`
		`+ .TH HATCH\-ENV\-REMOVE "1" "March 2022" "" "User Commands"`
		`+ .SH NAME`
		`+ .B hatch\ env\ remove`
		`+ \(en Remove environments`
		`+ .SH SYNOPSIS`
		`+ .B hatch\ env\ remove`
		`+ .RI [ OPTIONS ]`
		`+ .SH OPTIONS`
		`+ .TP`
		`+ .B \-h\fR, \fB\-\-help`
		`+ Show a help message and exit`
		`+ .SH "SEE ALSO"`
		`+ .BR hatch (1),`
		`+ .BR hatch\-env (1)`

hatch-env-show.1

file added

+17

		`@@ -0,0 +1,17 @@`
		`+ .TH HATCH\-ENV\-SHOW "1" "March 2022" "" "User Commands"`
		`+ .SH NAME`
		`+ .B hatch\ env\ show`
		`+ \(en Show the available environments`
		`+ .SH SYNOPSIS`
		`+ .B hatch\ env\ show`
		`+ .RI [ OPTIONS ]`
		`+ .SH OPTIONS`
		`+ .TP`
		`+ .B \-\-ascii`
		`+ Whether or not to only use ASCII characters`
		`+ .TP`
		`+ .B \-h\fR, \fB\-\-help`
		`+ Show a help message and exit`
		`+ .SH "SEE ALSO"`
		`+ .BR hatch (1),`
		`+ .BR hatch\-env (1)`

hatch-env.1

file modified

+41 -88

		`@@ -1,99 +1,52 @@`
		`- .TH HATCH\-ENV "1" "Feburary 2022" "" "User Commands"`
		`+ .TH HATCH\-ENV "1" "March 2022" "" "User Commands"`
		`.SH NAME`
		`.B hatch\ env`
		`- \(en Manages virtual environments`
		`+ \(en Manage project environments`
		`.SH SYNOPSIS`
		`.B hatch\ env`
		`.RI [ OPTIONS ]`
		`- .I NAME`
		`- .SH DESCRIPTION`
		`- .P`
		`- Creates a new virtual env that can later be utilized with the`
		`- .BR hatch\-shell (1)`
		`- command.`
		`+ .I COMMAND`
		`+ .RI [ ARGS ]...`
		`.SH OPTIONS`
		`.TP`
		`- .B \-py\fR, \fB\-\-python\ \fITEXT`
		`- The named Python path to use.`
		`- This overrides`
		`- .BR \-\-pypath .`
		`- .TP`
		`- .B \-pp\fR, \fB\-\-pypath\ \fITEXT`
		`- An absolute path to a Python executable.`
		`- .TP`
		`- .B \-g\fR, \fB\-\-global\-packages`
		`- Gives the virtual environment`
		`- access to the global site-packages.`
		`- .TP`
		`- .B \-c\fR, \fB\-\-clone`
		`- Specifies an existing virtual env to clone.`
		`- .BI ( Experimental )`
		`- .TP`
		`- .B \-v\fR, \fB\-\-verbose`
		`- Increases verbosity.`
		`- .TP`
		`- .B \-r\fR, \fB\-\-restore`
		`- Attempts to make all virtual envs in`
		`- .B /builddir/.virtualenvs`
		`- usable by fixing the`
		`- executable paths in scripts and removing all compiled`
		`- .B *.pyc`
		`- files.`
		`- .BI ( Experimental )`
		`- .TP`
		`- .B \-l\fR, \fB\-\-list`
		`- Shows available virtual envs.`
		`- Can stack up to 3 times to show more info.`
		`- .TP`
		`.B \-h\fR, \fB\-\-help`
		`- Show a help message and exit.`
		`- .SH EXAMPLES`
		`- .P`
		`- .in +7n`
		`- .EX`
		`- .B $\ hatch\ pypath\ \-l`
		`- .B py2 \-> /usr/bin/python`
		`- .B py3 \-> /usr/bin/python3`
		`- .B $\ hatch\ env\ \-l`
		- .B No virtual environments found in /home/ofek/.virtualenvs. To create one do `hatch env NAME`.
		`- .B $\ hatch\ env\ my\-app`
		`- .B Already using interpreter /usr/bin/python3`
		- .B Successfully saved virtual env `my\-app` to `/home/ofek/.virtualenvs/my\-app`.
		`- .B $\ hatch\ env\ \-py\ py2\ old`
		- .B Successfully saved virtual env `old` to `/home/ofek/.virtualenvs/old`.
		`- .B $\ hatch\ env\ \-pp\ ~/pypy3/bin/pypy\ fast`
		- .B Successfully saved virtual env `fast` to `/home/ofek/.virtualenvs/fast`.
		`- .B $\ hatch\ env\ \-ll`
		`- .B Virtual environments found in /home/ofek/.virtualenvs:`
		`- .B \`
		`- .B fast\ \->`
		`- .B \ \ Version:\ 3.5.3`
		`- .B \ \ Implementation:\ PyPy`
		`- .B my\-app\ \->`
		`- .B \ \ Version:\ 3.5.2`
		`- .B \ \ Implementation:\ CPython`
		`- .B old\ \->`
		`- .B \ \ Version:\ 2.7.12`
		`- .B \ \ Implementation:\ CPython`
		`- .EE`
		`- .in`
		`+ Show a help message and exit`
		`+ .SS "COMMANDS"`
		`+ .TP`
		`+ .B create`
		`+ Create environments`
		`+ .IP`
		`+ See`
		`+ .BR hatch\-env\-create (1).`
		`+ .TP`
		`+ .B find`
		`+ Locate environments`
		`+ .IP`
		`+ See`
		`+ .BR hatch\-env\-find (1).`
		`+ .TP`
		`+ .B prune`
		`+ Remove all environments`
		`+ .IP`
		`+ See`
		`+ .BR hatch\-env\-prune (1).`
		`+ .TP`
		`+ .B remove`
		`+ Remove environments`
		`+ .IP`
		`+ See`
		`+ .BR hatch\-env\-remove (1).`
		`+ .TP`
		`+ .B show`
		`+ Show the available environments`
		`+ .IP`
		`+ See`
		`+ .BR hatch\-env\-show (1).`
		`.SH "SEE ALSO"`
		`.BR hatch (1)`
		`.P`
		`- .BR hatch\-build (1),`
		`- .BR hatch\-clean (1),`
		`- .BR hatch\-conda (1),`
		`- .BR hatch\-config (1),`
		`- .\" .BR hatch\-env (1),`
		`- .BR hatch\-grow (1),`
		`- .BR hatch\-init (1),`
		`- .BR hatch\-install (1),`
		`- .BR hatch\-new (1),`
		`- .BR hatch\-pypath (1),`
		`- .BR hatch\-python (1),`
		`- .BR hatch\-release (1),`
		`- .BR hatch\-shed (1),`
		`- .BR hatch\-shell (1),`
		`- .BR hatch\-test (1),`
		`- .BR hatch\-uninstall (1),`
		`- .BR hatch\-update (1)`
		`+ .BR hatch\-env\-create (1),`
		`+ .BR hatch\-env\-find (1),`
		`+ .BR hatch\-env\-prune (1),`
		`+ .BR hatch\-env\-remove (1),`
		`+ .BR hatch\-env\-show (1)`

hatch-grow.1

file removed

-133

		`@@ -1,133 +0,0 @@`
		`- .TH HATCH\-GROW "1" "Feburary 2022" "" "User Commands"`
		`- .SH NAME`
		`- .B hatch\ grow`
		`- \(en Increments a project\(cqs version`
		`- .SH SYNOPSIS`
		`- .B hatch\ grow`
		`- .RI [ OPTIONS ]`
		`- .RB { major \| minor \| patch \| fix \| pre \| build }`
		`- .RI [ PACKAGE ]`
		`- .SH DESCRIPTION`
		`- .P`
		`- Increments a project\(cqs version number using semantic versioning.`
		`- Valid choices for the part are`
		`- .BR major ,`
		`- .BR minor ,`
		`- .B patch`
		`- .RB ( fix`
		`- alias),`
		`- .BR pre ,`
		`- and`
		`- .BR build .`
		`- .P`
		`- The path to the project is derived in the following order:`
		`- .RS +7n`
		`- .IP 1. +3n`
		`- The optional argument, which should be`
		`- the name of a package that was installed via`
		`- .B hatch install \-l`
		`- or`
		`- .B pip install \-e\fR.`
		`- .IP 2. +3n`
		`- The`
		`- .B \-\-local`
		`- flag.`
		`- .IP 3. +3n`
		`- The option`
		`- .BR \-\-path ,`
		`- which can be a relative or absolute path.`
		`- .IP 4. +3n`
		`- The current directory.`
		`- .RE`
		`- .P`
		`- If the path is a file, it will be the target.`
		`- Otherwise, the path, and every top level directory within,`
		`- will be checked for a`
		`- .BR __version__.py ,`
		`- .BR __about__.py ,`
		`- and`
		`- .BR __init__.py ,`
		`- in that order.`
		`- The first encounter of a`
		`- .B __version__`
		`- variable that also appears to equal a version string`
		`- will be updated.`
		`- Probable package paths will be given precedence.`
		`- .P`
		`- The default tokens for the prerelease and build parts,`
		`- .B rc`
		`- and`
		`- .B build`
		`- respectively, can be altered via the options`
		`- .B \-\-pre`
		`- and`
		`- .BR \-\-build ,`
		`- or the config entry`
		`- .BR semver .`
		`- .SH OPTIONS`
		`- .TP`
		`- .B \-l\fR, \fB\-\-local`
		`- Shortcut to select the only available local (editable) package.`
		`- If there are multiple, an error will be raised.`
		`- .TP`
		`- .B \-p\fR, \fB\-\-path\ \fITEXT`
		`- A relative or absolute path to a project or file.`
		`- .TP`
		`- .B \-pre\ \fITEXT`
		`- The token to use for`
		`- .B pre`
		`- part, overriding the config file.`
		`- Default:`
		`- .B rc`
		`- .TP`
		`- .B \-build\ \fITEXT`
		`- The token to use for`
		`- .B build`
		`- part, overriding the config file.`
		`- Default:`
		`- .B build`
		`- .TP`
		`- .B \-h\fR, \fB\-\-help`
		`- Show a help message and exit.`
		`- .SH EXAMPLES`
		`- .P`
		`- .in +7n`
		`- .EX`
		`- .B $\ git\ clone\ \-q\ https://github.com/requests/requests\ && cd\ requests`
		`- .B $\ hatch\ grow\ build`
		`- .B Updated\ /home/ofek/requests/requests/__version__.py`
		`- .B 2.18.4\ \->\ 2.18.4+build.1`
		`- .B $\ hatch\ grow\ fix`
		`- .B Updated\ /home/ofek/requests/requests/__version__.py`
		`- .B 2.18.4+build.1\ \->\ 2.18.5`
		`- .B $\ hatch\ grow\ pre`
		`- .B Updated\ /home/ofek/requests/requests/__version__.py`
		`- .B 2.18.5\ \->\ 2.18.5\-rc.1`
		`- .B $\ hatch\ grow\ minor`
		`- .B Updated\ /home/ofek/requests/requests/__version__.py`
		`- .B 2.18.5\-rc.1\ \->\ 2.19.0`
		`- .B $\ hatch\ grow\ major`
		`- .B Updated\ /home/ofek/requests/requests/__version__.py`
		`- .B 2.19.0\ \->\ 3.0.0`
		`- .EE`
		`- .in`
		`- .SH "SEE ALSO"`
		`- .BR hatch (1)`
		`- .P`
		`- .BR hatch\-build (1),`
		`- .BR hatch\-clean (1),`
		`- .BR hatch\-conda (1),`
		`- .BR hatch\-config (1),`
		`- .BR hatch\-env (1),`
		`- .\" .BR hatch\-grow (1),`
		`- .BR hatch\-init (1),`
		`- .BR hatch\-install (1),`
		`- .BR hatch\-new (1),`
		`- .BR hatch\-pypath (1),`
		`- .BR hatch\-python (1),`
		`- .BR hatch\-release (1),`
		`- .BR hatch\-shed (1),`
		`- .BR hatch\-shell (1),`
		`- .BR hatch\-test (1),`
		`- .BR hatch\-uninstall (1),`
		`- .BR hatch\-update (1)`

hatch-init.1

file removed

-119

		`@@ -1,119 +0,0 @@`
		`- .TH HATCH\-INIT "1" "Feburary 2022" "" "User Commands"`
		`- .SH NAME`
		`- .B hatch\ init`
		`- \(en Creates a new Python project in the current directory`
		`- .SH SYNOPSIS`
		`- .B hatch\ init`
		`- .RI [ OPTIONS ]`
		`- .RI [ NAME ]`
		`- .SH DESCRIPTION`
		`- .P`
		`- Creates a new Python project in the current directory.`
		`- .P`
		`- Values from your config file such as`
		`- .B name`
		`- and`
		`- .B pyversions`
		`- will be used to help populate fields.`
		`- You can also specify things like the readme format and`
		`- which CI service files to create.`
		`- All options override the config file.`
		`- .P`
		`- By default a virtual env will be created`
		`- in the project directory`
		`- and will install the project locally`
		`- so any edits will auto-update the installation.`
		`- You can also locally install the created project`
		`- in other virtual envs using the`
		`- .B \-\-env`
		`- option.`
		`- .SH OPTIONS`
		`- .TP`
		`- .B \-ne\fR, \fB\-\-no\-env`
		`- Disables the creation of a dedicated virtual env.`
		`- .TP`
		`- .B \-py\fR, \fB\-\-python\ \fITEXT`
		`- A named Python path to use when creating a virtual env.`
		`- This overrides`
		`- .BR \-\-pypath .`
		`- .TP`
		`- .B \-pp\fR, \fB\-\-pypath\ \fITEXT`
		`- An absolute path to a Python executable to use when`
		`- creating a virtual env.`
		`- .TP`
		`- .B \-g\fR, \fB\-\-global\-packages`
		`- Gives created virtual envs access to the global site- packages.`
		`- .TP`
		`- .B \-e\fR, \fB\-\-env\ \fITEXT`
		`- Forward-slash-separated list of named virtual envs to be installed in.`
		`- Will create any that don\(cqt already exist.`
		`- .TP`
		`- .B \-\-basic`
		`- Disables third-party services and readme badges.`
		`- .TP`
		`- .B \-\-cli`
		`- Creates a`
		`- .B cli.py`
		`- in the package directory and an entry point in`
		`- .B setup.py`
		`- pointing to the properly named function within.`
		`- Also, a`
		`- .B __main__.py`
		`- is created so it can be invoked via`
		`- .BR python\ \-m\ pkg_name .`
		`- .TP`
		`- .B \-l\fR, \fB\-\-licenses\ \fITEXT`
		`- Comma-separated list of licenses to use.`
		`- .TP`
		`- .B \-i\fR, \fB\-\-interactive`
		`- Invokes interactive mode.`
		`- .TP`
		`- .B \-h\fR, \fB\-\-help`
		`- Show a help message and exit.`
		`- .SH EXAMPLES`
		`- .P`
		`- Here is an example using an unmodified config file:`
		`- .P`
		`- .in +7n`
		`- .EX`
		`- .B $\ hatch\ init\ my\-app`
		- .B Created\ project\ `my\-app`\ here
		`- .B $\ tree\ \-\-dirsfirst\ .`
		`- .B .`
		`- .B \[u251C]\[u2500]\[u2500]\ my_app`
		`- .B \[u2502]\ \ \ \[u2514]\[u2500]\[u2500]\ __init__.py`
		`- .B \[u251C]\[u2500]\[u2500] tests`
		`- .B \[u2502]\ \ \ \[u2514]\[u2500]\[u2500]\ __init__.py`
		`- .B \[u251C]\[u2500]\[u2500]\ LICENSE\-APACHE`
		`- .B \[u251C]\[u2500]\[u2500]\ LICENSE\-MIT`
		`- .B \[u251C]\[u2500]\[u2500]\ MANIFEST.in`
		`- .B \[u251C]\[u2500]\[u2500]\ README.rst`
		`- .B \[u251C]\[u2500]\[u2500]\ requirements.txt`
		`- .B \[u251C]\[u2500]\[u2500]\ setup.py`
		`- .B └──\ tox.ini`
		`- .B \`
		`- .B 2\ directories,\ 8\ files`
		`- .EE`
		`- .in`
		`- .SH "SEE ALSO"`
		`- .BR tree (1)`
		`- .P`
		`- .BR hatch (1)`
		`- .P`
		`- .BR hatch\-build (1),`
		`- .BR hatch\-clean (1),`
		`- .BR hatch\-conda (1),`
		`- .BR hatch\-config (1),`
		`- .BR hatch\-env (1),`
		`- .BR hatch\-grow (1),`
		`- .\" .BR hatch\-init (1),`
		`- .BR hatch\-install (1),`
		`- .BR hatch\-new (1),`
		`- .BR hatch\-pypath (1),`
		`- .BR hatch\-python (1),`
		`- .BR hatch\-release (1),`
		`- .BR hatch\-shed (1),`
		`- .BR hatch\-shell (1),`
		`- .BR hatch\-test (1),`
		`- .BR hatch\-uninstall (1),`
		`- .BR hatch\-update (1)`

hatch-install.1

file removed

-91

		`@@ -1,91 +0,0 @@`
		`- .TH HATCH\-INSTALL "1" "Feburary 2022" "" "User Commands"`
		`- .SH NAME`
		`- .B hatch\ install`
		`- \(en Installs packages`
		`- .SH SYNOPSIS`
		`- .B hatch\ install`
		`- .RI [ OPTIONS ]`
		`- .RI [ PACKAGES ]...`
		`- .SH DESCRIPTION`
		`- .P`
		`- If the option`
		`- .B \-\-env`
		`- is supplied, the install will be applied using that named virtual env.`
		`- Unless the option`
		`- .B \-\-global`
		`- is selected, the install will only affect the current user.`
		`- Of course, this will have no effect if a virtual env is in use.`
		`- The desired name of the admin user can be set with the`
		`- .B _DEFAULT_ADMIN_`
		`- environment variable.`
		`- .P`
		`- With no packages selected, this will install using a`
		`- .B setup.py`
		`- in the current directory.`
		`- .P`
		`- If no`
		`- .B \-\-env`
		`- is chosen, this will attempt to detect a project and use its`
		`- virtual env before resorting to the default`
		`- .BR pip (1).`
		`- No project detection will occur if a virtual env is active.`
		`- .SH OPTIONS`
		`- .TP`
		`- .B \-nd\fR, \fB\-\-no\-detect`
		`- Disables the use of a project\(cqs dedicated virtual env.`
		`- This is useful if you need to be in a project root but`
		`- wish to not target its virtual env.`
		`- .B \-e\fR, \fB\-\-env\ \fITEXT`
		`- The named virtual env to use.`
		`- .TP`
		`- .B \-l\fR, \fB\-\-local`
		`- Corresponds to`
		`- .BR pip (1)\(cqs`
		`- .B \-\-editable`
		`- option, allowing a local package to be`
		`- automatically updated when modifications are made.`
		`- .TP`
		`- .B \-g\fR, \fB\-\-global`
		`- Installs globally, rather than on a per-user basis.`
		`- This has no effect if a virtual env is in use.`
		`- .TP`
		`- .B \-\-admin`
		`- When`
		`- .B \-\-global`
		`- is selected, this assumes admin rights are`
		`- already enabled and therefore`
		`- .BR sudo (8)/ runas`
		`- will not be used.`
		`- .TP`
		`- .B \-a\fR, \fB\-\-quiet`
		`- Decreases verbosity.`
		`- .TP`
		`- .B \-h\fR, \fB\-\-help`
		`- Show a help message and exit.`
		`- .SH ENVIRONMENT`
		`- .TP`
		`- .B _DEFAULT_ADMIN_`
		`- Desired name of the admin user`
		`- .SH "SEE ALSO"`
		`- .BR pip (1),`
		`- .BR sudo (8)`
		`- .P`
		`- .BR hatch (1)`
		`- .P`
		`- .BR hatch\-build (1),`
		`- .BR hatch\-clean (1),`
		`- .BR hatch\-conda (1),`
		`- .BR hatch\-config (1),`
		`- .BR hatch\-env (1),`
		`- .BR hatch\-grow (1),`
		`- .BR hatch\-init (1),`
		`- .\" .BR hatch\-install (1),`
		`- .BR hatch\-new (1),`
		`- .BR hatch\-pypath (1),`
		`- .BR hatch\-python (1),`
		`- .BR hatch\-release (1),`
		`- .BR hatch\-shed (1),`
		`- .BR hatch\-shell (1),`
		`- .BR hatch\-test (1),`
		`- .BR hatch\-uninstall (1),`
		`- .BR hatch\-update (1)`

hatch-new.1

file modified

+9 -104

		`@@ -1,119 +1,24 @@`
		`- .TH HATCH\-NEW "1" "Feburary 2022" "" "User Commands"`
		`+ .TH HATCH\-NEW "1" "March 2022" "" "User Commands"`
		`.SH NAME`
		`.B hatch\ new`
		`- \(en Creates a new Python project`
		`+ \(en Create or initialize a project`
		`.SH SYNOPSIS`
		`.B hatch\ new`
		`.RI [ OPTIONS ]`
		`.RI [ NAME ]`
		`- .SH DESCRIPTION`
		`- .P`
		`- Creates a new Python project.`
		`- .P`
		`- Values from your config file such as`
		`- .B name`
		`- and`
		`- .B pyversions`
		`- will be used to help populate fields.`
		`- You can also specify things like the readme format and`
		`- which CI service files to create.`
		`- All options override the config file.`
		`- .P`
		`- By default a virtual env will be created`
		`- in the project directory`
		`- and will install the project locally`
		`- so any edits will auto-update the installation.`
		`- You can also locally install the created project`
		`- in other virtual envs using the`
		`- .B \-\-env`
		`- option.`
		`+ .RI [ LOCATION ]`
		`.SH OPTIONS`
		`.TP`
		`- .B \-ne\fR, \fB\-\-no\-env`
		`- Disables the creation of a dedicated virtual env.`
		`- .TP`
		`- .B \-py\fR, \fB\-\-python\ \fITEXT`
		`- A named Python path to use when creating a virtual env.`
		`- This overrides`
		`- .BR \-\-pypath .`
		`- .TP`
		`- .B \-pp\fR, \fB\-\-pypath\ \fITEXT`
		`- An absolute path to a Python executable to use when`
		`- creating a virtual env.`
		`- .TP`
		`- .B \-g\fR, \fB\-\-global\-packages`
		`- Gives created virtual envs access to the global site- packages.`
		`- .TP`
		`- .B \-e\fR, \fB\-\-env\ \fITEXT`
		`- Forward-slash-separated list of named virtual envs to be installed in.`
		`- Will create any that don\(cqt already exist.`
		`- .TP`
		`- .B \-\-basic`
		`- Disables third-party services and readme badges.`
		`+ .B \-i\fR, \fB\-\-interactive`
		`+ Interactively choose details about the project`
		`.TP`
		`.B \-\-cli`
		`- Creates a`
		`- .B cli.py`
		`- in the package directory and an entry point in`
		`- .B setup.py`
		`- pointing to the properly named function within.`
		`- Also, a`
		`- .B __main__.py`
		`- is created so it can be invoked via`
		`- .BR python\ \-m\ pkg_name .`
		`+ Give the project a command line interface`
		`.TP`
		`- .B \-l\fR, \fB\-\-licenses\ \fITEXT`
		`- Comma-separated list of licenses to use.`
		`- .TP`
		`- .B \-i\fR, \fB\-\-interactive`
		`- Invokes interactive mode.`
		`+ .B \-\-init`
		`+ Initialize an existing project`
		`.TP`
		`.B \-h\fR, \fB\-\-help`
		`- Show a help message and exit.`
		`- .SH EXAMPLES`
		`- .P`
		`- Here is an example using an unmodified config file:`
		`- .P`
		`- .in +7n`
		`- .EX`
		`- .B $\ hatch\ new\ my\-app`
		- .B Created\ project\ `my\-app`\ here
		`- .B $\ tree\ \-\-dirsfirst\ my\-app`
		`- .B my\-app`
		`- .B \[u251C]\[u2500]\[u2500]\ my_app`
		`- .B \[u2502]\ \ \ \[u2514]\[u2500]\[u2500]\ __init__.py`
		`- .B \[u251C]\[u2500]\[u2500] tests`
		`- .B \[u2502]\ \ \ \[u2514]\[u2500]\[u2500]\ __init__.py`
		`- .B \[u251C]\[u2500]\[u2500]\ LICENSE\-APACHE`
		`- .B \[u251C]\[u2500]\[u2500]\ LICENSE\-MIT`
		`- .B \[u251C]\[u2500]\[u2500]\ MANIFEST.in`
		`- .B \[u251C]\[u2500]\[u2500]\ README.rst`
		`- .B \[u251C]\[u2500]\[u2500]\ requirements.txt`
		`- .B \[u251C]\[u2500]\[u2500]\ setup.py`
		`- .B └──\ tox.ini`
		`- .B \`
		`- .B 2\ directories,\ 8\ files`
		`- .EE`
		`- .in`
		`+ Show a help message and exit`
		`.SH "SEE ALSO"`
		`- .BR tree (1)`
		`- .P`
		`.BR hatch (1)`
		`- .P`
		`- .BR hatch\-build (1),`
		`- .BR hatch\-clean (1),`
		`- .BR hatch\-conda (1),`
		`- .BR hatch\-config (1),`
		`- .BR hatch\-env (1),`
		`- .BR hatch\-grow (1),`
		`- .BR hatch\-init (1),`
		`- .BR hatch\-install (1),`
		`- .\" .BR hatch\-new (1),`
		`- .BR hatch\-pypath (1),`
		`- .BR hatch\-python (1),`
		`- .BR hatch\-release (1),`
		`- .BR hatch\-shed (1),`
		`- .BR hatch\-shell (1),`
		`- .BR hatch\-test (1),`
		`- .BR hatch\-uninstall (1),`
		`- .BR hatch\-update (1)`

hatch-publish.1

file added

+77

		`@@ -0,0 +1,77 @@`
		`+ .TH HATCH\-PUBLISH "1" "March 2022" "" "User Commands"`
		`+ .SH NAME`
		`+ .B hatch\ publish`
		`+ \(en Build a project`
		`+ .SH SYNOPSIS`
		`+ .B hatch\ publish`
		`+ .RI [ OPTIONS ]`
		`+ .RI [ ARTIFACTS ]...`
		`+ .SH OPTIONS`
		`+ .TP`
		`+ .B \-u\fR, \fB\-\-user\ \fITEXT`
		`+ The user with which to authenticate`
		`+ [env var:`
		`+ .BR HATCH_PYPI_USER ]`
		`+ .TP`
		`+ .B \-a\fR, \fB\-\-auth\ \fITEXT`
		`+ The credentials to use for authentication`
		`+ [env var:`
		`+ .BR HATCH_PYPI_AUTH ]`
		`+ .TP`
		`+ .B \-r\fR, \fB\-\-repo\ \fITEXT`
		`+ The repository with which to publish artifacts`
		`+ [env var:`
		`+ .BR HATCH_PYPI_REPO ]`
		`+ .TP`
		`+ .B \-n\fR, \fB\-\-no\-prompt`
		`+ Do not prompt for missing required fields`
		`+ .TP`
		`+ .B \-p\fR, \fB\-\-publisher\ \fITEXT`
		`+ The publisher plugin to use (default is`
		`+ .BR pypi )`
		`+ [env var:`
		`+ .BR HATCH_PUBLISHER ]`
		`+ .TP`
		`+ .B \-o\fR, \fB\-\-option\ \fITEXT`
		`+ Options to pass to the publisher plugin.`
		`+ This may be selected multiple times`
		`+ e.g. \fB\-o\ foo=bar \-o\ baz=23`
		`+ [env var:`
		`+ .BR HATCH_PUBLISHER_OPTIONS ]`
		`+ .TP`
		`+ .B \-h\fR, \fB\-\-help`
		`+ Show a help message and exit`
		`+ .SH ENVIRONMENT`
		`+ .TP`
		`+ .B HATCH_PYPI_USER`
		`+ The user with which to authenticate`
		`+ [option:`
		`+ .BR \-u ,`
		`+ .BR \-\-user ]`
		`+ .TP`
		`+ .B HATCH_PYPI_AUTH`
		`+ The credentials to use for authentication`
		`+ [option:`
		`+ .BR \-a ,`
		`+ .BR \-\-auth ]`
		`+ .TP`
		`+ .B HATCH_PYPI_REPO`
		`+ The repository with which to publish artifacts`
		`+ [option:`
		`+ .BR \-r ,`
		`+ .BR \-\-repo ]`
		`+ .TP`
		`+ .B HATCH_PUBLISHER`
		`+ The publisher plugin to use (default is`
		`+ .BR pypi )`
		`+ [option:`
		`+ .BR \-p ,`
		`+ .BR \-\-publisher ]`
		`+ .TP`
		`+ .B HATCH_PUBLISHER_OPTIONS`
		`+ Options to pass to the publisher plugin`
		`+ [option:`
		`+ .BR \-o ,`
		`+ .BR \-\-option ]`
		`+ .SH "SEE ALSO"`
		`+ .BR hatch (1)`

hatch-pypath.1

file removed

-58

		`@@ -1,58 +0,0 @@`
		`- .TH HATCH\-PYPATH "1" "Feburary 2022" "" "User Commands"`
		`- .SH NAME`
		`- .B hatch\ pypath`
		`- \(en Manages named Python paths`
		`- .SH SYNOPSIS`
		`- .B hatch\ pypath`
		`- .RI [ OPTIONS ]`
		`- .I NAME`
		`- .I PATH`
		`- .SH DESCRIPTION`
		`- .P`
		`- Names an absolute path to a Python executable.`
		`- You can also modify these in the config file entry`
		`- .BR pypaths .`
		`- Hatch can then use these paths by name when creating virtual envs,`
		`- building packages, etc.`
		`- .SH OPTIONS`
		`- .TP`
		`- .B \-l\fR, \fB\-\-list`
		`- Shows available Python paths.`
		`- .TP`
		`- .B \-h\fR, \fB\-\-help`
		`- Show a help message and exit.`
		`- .SH EXAMPLES`
		`- .P`
		`- .in +7n`
		`- .EX`
		`- .B $\ hatch\ pypath\ \-l`
		- .B There are no saved Python paths. Add one via `hatch pypath NAME PATH`.
		`- .B $\ hatch\ pypath\ py2\ /usr/bin/python`
		- .B Successfully saved Python `py2` located at `/usr/bin/python`.
		`- .B $\ hatch\ pypath\ py3\ /usr/bin/python3`
		- .B Successfully saved Python `py3` located at `/usr/bin/python3`.
		`- .B $\ hatch\ pypath\ \-l`
		`- .B py2 -> /usr/bin/python`
		`- .B py3 -> /usr/bin/python3`
		`- .EE`
		`- .in`
		`- .SH "SEE ALSO"`
		`- .BR hatch (1)`
		`- .P`
		`- .BR hatch\-build (1),`
		`- .BR hatch\-clean (1),`
		`- .BR hatch\-conda (1),`
		`- .BR hatch\-config (1),`
		`- .BR hatch\-env (1),`
		`- .BR hatch\-grow (1),`
		`- .BR hatch\-init (1),`
		`- .BR hatch\-install (1),`
		`- .BR hatch\-new (1),`
		`- .\" .BR hatch\-pypath (1),`
		`- .BR hatch\-python (1),`
		`- .BR hatch\-release (1),`
		`- .BR hatch\-shed (1),`
		`- .BR hatch\-shell (1),`
		`- .BR hatch\-test (1),`
		`- .BR hatch\-uninstall (1),`
		`- .BR hatch\-update (1)`

hatch-python.1

file removed

-37

		`@@ -1,37 +0,0 @@`
		`- .TH HATCH\-PYTHON "1" "Feburary 2022" "" "User Commands"`
		`- .SH NAME`
		`- .B hatch\ python`
		`- \(en Manages Python installations`
		`- .SH SYNOPSIS`
		`- .B hatch\ python`
		`- .RI [ OPTIONS ]`
		`- .I VERSION`
		`- .RI [ NAME ]`
		`- .SH OPTIONS`
		`- .TP`
		`- .B \-\-head\fR\ / \fB\-\-tail`
		`- Adds the installation to the head or tail of the user`
		`- .BR PATH .`
		`- .TP`
		`- .B \-h\fR, \fB\-\-help`
		`- Show a help message and exit.`
		`- .SH "SEE ALSO"`
		`- .BR hatch (1)`
		`- .P`
		`- .BR hatch\-build (1),`
		`- .BR hatch\-clean (1),`
		`- .BR hatch\-conda (1),`
		`- .BR hatch\-config (1),`
		`- .BR hatch\-env (1),`
		`- .BR hatch\-grow (1),`
		`- .BR hatch\-init (1),`
		`- .BR hatch\-install (1),`
		`- .BR hatch\-new (1),`
		`- .BR hatch\-pypath (1),`
		`- .\" .BR hatch\-python (1),`
		`- .BR hatch\-release (1),`
		`- .BR hatch\-shed (1),`
		`- .BR hatch\-shell (1),`
		`- .BR hatch\-test (1),`
		`- .BR hatch\-uninstall (1),`
		`- .BR hatch\-update (1)`

hatch-release.1

file removed

-143

		`@@ -1,143 +0,0 @@`
		`- .TH HATCH\-RELEASE "1" "Feburary 2022" "" "User Commands"`
		`- .SH NAME`
		`- .B hatch\ release`
		`- \(en Uploads to PyPI`
		`- .SH SYNOPSIS`
		`- .B hatch\ release`
		`- .RI [ OPTIONS ]`
		`- .RI [ PACKAGE ]`
		`- .SH DESCRIPTION`
		`- .P`
		`- Uploads all files in a directory to PyPI using`
		`- .BR twine (1).`
		`- .P`
		`- The path to the build directory is derived in the following order:`
		`- .RS +7n`
		`- .IP 1. +3n`
		`- The optional argument, which should be`
		`- the name of a package that was installed via`
		`- .B hatch install \-l`
		`- or`
		`- .B pip install \-e\fR.`
		`- .IP 2. +3n`
		`- The`
		`- .B \-\-local`
		`- flag.`
		`- .IP 3. +3n`
		`- The option`
		`- .BR \-\-path ,`
		`- which can be a relative or absolute path.`
		`- .IP 4. +3n`
		`- The current directory.`
		`- If the current directory has a`
		`- .B dist`
		`- directory, that will be used instead.`
		`- .RE`
		`- .P`
		`- If the path was derived from the optional package argument,`
		`- the files must be in a directory named`
		`- .BR dist .`
		`- .P`
		`- The PyPI username can be saved in the config file entry`
		`- .B pypi_username`
		`- or the`
		`- .B TWINE_USERNAME`
		`- environment variable.`
		- If the `TWINE_PASSWORD` environment variable is not set,
		`- a hidden prompt will be provided for the password.`
		`- .SH OPTIONS`
		`- .TP`
		`- .B \-l\fR, \fB\-\-local`
		`- Shortcut to select the only available local (editable) package.`
		`- If there are multiple, an error will be raised.`
		`- .TP`
		`- .B \-p\fR, \fB\-\-path\ \fITEXT`
		`- A relative or absolute path to a project.`
		`- .TP`
		`- .B \-u\fR, \fB\-\-username\ \fITEXT`
		`- The PyPI username to use.`
		`- .TP`
		`- .B \-r\fR, \fB\-\-repo\ \fITEXT`
		`- The PyPI repository to use (default:`
		`- .UR https://upload.pypi.org/legacy/`
		`- .UE ).`
		`- Should be a section in the`
		`- .B .pypirc`
		`- file.`
		`- (Can also be set via`
		`- .B TWINE_REPOSITORY`
		`- environment variable)`
		`- .TP`
		`- .B \-ru\fR, \fB\-\-repo\-url\ \fITEXT`
		`- The repository URL to upload the package to.`
		`- This overrides`
		`- .BR \-\-repository .`
		`- (Can also be set via`
		`- .B TWINE_REPOSITORY_URL`
		`- environment variable)`
		`- .TP`
		`- .B \-t\fR, \fB\-\-test`
		`- Uses the test version of PyPI.`
		`- Equivalent to`
		`- .B \-r\ https://test.pypi.org/legacy/`
		`- .TP`
		`- .B \-s\fR, \fB\-\-strict`
		`- Aborts if a distribution already exists.`
		`- .B \-h\fR, \fB\-\-help`
		`- Show a help message and exit.`
		`- .SH ENVIRONMENT`
		`- .TP`
		`- .B TWINE_USERNAME`
		`- PyPI username (or, use the`
		`- .B pypi_username`
		`- config file entry or`
		`- .BR \-u / \-\-username )`
		`- .TP`
		`- .B TWINE_PASSWORD`
		`- PyPI password (or, use a hidden prompt)`
		`- .TP`
		`- .B TWINE_REPOSITORY`
		`- PyPI repository to use (or, use`
		`- .BR \-r / \-\-repo ,`
		`- .BR \-ru / \-\-repo\-url ,`
		`- or the`
		`- .B TWINE_REPOSITORY_URL`
		`- environment variable)`
		`- .TP`
		`- .B TWINE_REPOSITORY_URL`
		`- PyPI repository URL to upload the package to (or, use`
		`- .BR \-ru / \-\-repo\-url ,`
		`- .BR \-r / \-\-repo ,`
		`- or the`
		`- .B TWINE_REPOSITORY`
		`- environment variable)`
		`- .SH FILES`
		`- .TP`
		`- .B .pypirc`
		`- Should contain a section for the PyPI repository configured with`
		`- .BR \-r / \-\-repo`
		`- or with the`
		`- .B TWINE_REPOSITORY`
		`- environment variable.`
		`- .SH "SEE ALSO"`
		`- .BR twine (1)`
		`- .P`
		`- .BR hatch (1)`
		`- .P`
		`- .BR hatch\-build (1),`
		`- .BR hatch\-clean (1),`
		`- .BR hatch\-conda (1),`
		`- .BR hatch\-config (1),`
		`- .BR hatch\-env (1),`
		`- .BR hatch\-grow (1),`
		`- .BR hatch\-init (1),`
		`- .BR hatch\-install (1),`
		`- .BR hatch\-new (1),`
		`- .BR hatch\-pypath (1),`
		`- .BR hatch\-python (1),`
		`- .\" .BR hatch\-release (1),`
		`- .BR hatch\-shed (1),`
		`- .BR hatch\-shell (1),`
		`- .BR hatch\-test (1),`
		`- .BR hatch\-uninstall (1),`
		`- .BR hatch\-update (1)`

hatch-run.1

file added

+67

		`@@ -0,0 +1,67 @@`
		`+ .TH HATCH\-RUN "1" "March 2022" "" "User Commands"`
		`+ .SH NAME`
		`+ .B hatch\ run`
		`+ \(en Run commands within project environments`
		`+ .SH SYNOPSIS`
		`+ .B hatch\ run`
		`+ .RI [ OPTIONS ]`
		`+ .RI [ ENV :] ARGS ...`
		`+ .SH DESCRIPTION`
		`+ If the first argument contains a colon,`
		`+ then the preceding component will be`
		`+ interpreted as the name of the environment to target,`
		`+ overriding the`
		`+ .BR \-e / \-\-env`
		`+ root option and the`
		`+ .B HATCH_ENV`
		`+ environment variable.`
		`+ .P`
		`+ If the environment provides matrices,`
		`+ then you may also provide leading arguments`
		`+ starting with a`
		`+ .B +`
		`+ or`
		`+ .B \-`
		`+ to select or exclude certain variables,`
		`+ optionally followed by specific comma-separated values.`
		`+ .SH EXAMPLES`
		`+ For example, if you have the following configuration:`
		`+ .TP`
		`+ .in +4n`
		`+ .I pyproject.toml`
		`+ .EX`
		`+ .B [[tool.hatch.envs.test.matrix]]`
		`+ .B python\ =\ ["39",\ "310"]`
		`+ .B version\ =\ ["42",\ "3.14",\ "9000"]`
		`+ .EE`
		`+ .in`
		`+ .TP`
		`+ .in +4n`
		`+ .I hatch.toml`
		`+ .EX`
		`+ .B [[envs.test.matrix]]`
		`+ .B python\ =\ ["39",\ "310"]`
		`+ .B version\ =\ ["42",\ "3.14",\ "9000"]`
		`+ .EE`
		`+ .in`
		`+ .P`
		`+ then running:`
		`+ .P`
		`+ .in +4n`
		`+ .EX`
		`+ .B hatch\ run\ +py=310\ \-version=9000\ test:pytest`
		`+ .EE`
		`+ .in`
		`+ .P`
		`+ would execute`
		`+ .B pytest`
		`+ in the environments`
		`+ .B test.py310\-42`
		`+ and`
		`+ .BR test.py310\-3.14 .`
		`+ Note that`
		`+ .B py`
		`+ may be used as an alias for`
		`+ .BR python .`
		`+ .SH "SEE ALSO"`
		`+ .BR hatch (1)`

hatch-shed.1

file removed

-69

		`@@ -1,69 +0,0 @@`
		`- .TH HATCH\-SHED "1" "Feburary 2022" "" "User Commands"`
		`- .SH NAME`
		`- .B hatch\ shed`
		`- \(en Removes named Python paths or virtual environments`
		`- .SH SYNOPSIS`
		`- .B hatch\ shed`
		`- .RI [ OPTIONS ]`
		`- .SH DESCRIPTION`
		`- .P`
		`- Removes named Python paths or virtual environments.`
		`- .SH OPTIONS`
		`- .TP`
		`- .B \-p\fR, \fB\-py\fR, \fB\-\-pypath\ \fITEXT`
		`- Forward-slash-separated list of named Python paths.`
		`- .TP`
		`- .B \-e\fR, \fB\-env\ \fITEXT`
		`- Forward-slash-separated list of named virtual envs.`
		`- .TP`
		`- .B \-h\fR, \fB\-\-help`
		`- Show a help message and exit.`
		`- .SH EXAMPLES`
		`- .P`
		`- .in +7n`
		`- .EX`
		`- .B $\ hatch\ pypath\ \-l`
		`- .B py2 \-> /usr/bin/python`
		`- .B py3 \-> /usr/bin/python3`
		`- .B invalid \-> :\/:`
		`- .B $\ hatch\ env\ \-ll`
		`- .B Virtual environments found in /home/ofek/.virtualenvs:`
		`- .B \`
		`- .B duplicate \->`
		`- .B Version: 3.5.2`
		`- .B Implementation: CPython`
		`- .B fast \->`
		`- .B Version: 3.5.3`
		`- .B Implementation: PyPy`
		`- .B my\-app \->`
		`- .B Version: 3.5.2`
		`- .B Implementation: CPython`
		`- .B old \->`
		`- .B Version: 2.7.12`
		`- .B Implementation: CPython`
		`- .B $\ hatch\ shed\ \-p\ invalid\ \-e\ duplicate/old`
		- .B Successfully removed Python path named `invalid`.
		- .B Successfully removed virtual env named `duplicate`.
		- .B Successfully removed virtual env named `old`.
		`- .EE`
		`- .in`
		`- .SH "SEE ALSO"`
		`- .BR hatch (1)`
		`- .P`
		`- .BR hatch\-build (1),`
		`- .BR hatch\-clean (1),`
		`- .BR hatch\-conda (1),`
		`- .BR hatch\-config (1),`
		`- .BR hatch\-env (1),`
		`- .BR hatch\-grow (1),`
		`- .BR hatch\-init (1),`
		`- .BR hatch\-install (1),`
		`- .BR hatch\-new (1),`
		`- .BR hatch\-pypath (1),`
		`- .BR hatch\-python (1),`
		`- .BR hatch\-release (1),`
		`- .\" .BR hatch\-shed (1),`
		`- .BR hatch\-shell (1),`
		`- .BR hatch\-test (1),`
		`- .BR hatch\-uninstall (1),`
		`- .BR hatch\-update (1)`

hatch-shell.1

file modified

+7 -139

		`@@ -1,147 +1,15 @@`
		`- .TH HATCH\-SHELL "1" "Feburary 2022" "" "User Commands"`
		`+ .TH HATCH\-SHELL "1" "March 2022" "" "User Commands"`
		`.SH NAME`
		`.B hatch\ shell`
		`- \(en Activates or sends a command to a virtual environment`
		`+ \(en Enter a shell within a project\(cqs environment`
		`.SH SYNOPSIS`
		`.B hatch\ shell`
		`.RI [ OPTIONS ]`
		`- .RI [ ENV_NAME ]`
		`- .RI [ COMMAND ]...`
		`- .SH DESCRIPTION`
		`- .P`
		`- Activates or sends a command to a virtual environment.`
		`- A default shell name (or command)`
		`- can be specified in the config file entry`
		`- .B shell`
		`- or the environment variable`
		`- .BR SHELL .`
		`- If there is no entry, env var, nor shell option provided,`
		`- a system default will be used:`
		`- .B cmd`
		`- on Windows,`
		`- .BR bash (1)`
		`- otherwise.`
		`- .P`
		`- Any arguments provided after the first`
		`- will be sent to the virtual env`
		`- as a command without activating it.`
		`- If there is only the env without args,`
		`- it will be activated similarly to how you are accustomed.`
		`- The name of the virtual env to use must be omitted if using the`
		`- .B \-\-temp`
		`- env option.`
		`- If no env is chosen, this will attempt to detect a project`
		`- and activate its virtual env.`
		`- To run a command in a project\(cqs virtual env,`
		`- use \fB.\fR as the env name.`
		`- .P`
		`- Activation will not do anything to your current shell,`
		`- but will rather spawn a subprocess to avoid`
		`- any unwanted strangeness occurring in your current environment.`
		`- If you would like to learn more about the benefits of this approach,`
		`- be sure to read`
		`- .UR https://gist.github.com/datagrok/2199506`
		`- .UE .`
		`- To leave a virtual env, type`
		`- .BR exit (1),`
		`- or you can do`
		`- .B Ctrl+D`
		`- on non-Windows machines.`
		`- .P`
		`- .BR hatch\-use (1)`
		`- is an alias for this command.`
		`-`
		`- Options:`
		- -s, --shell TEXT The name of shell to use e.g. `bash`. If the shell
		- name is not supported, e.g. `bash -O`, it will be
		`- treated as a command and no custom prompt will be`
		`- provided. This overrides the config file entry`
		- `shell`.
		`- -t, --temp Use a new temporary virtual env.`
		`- -py, --python TEXT A named Python path to use when creating a temporary`
		`- virtual env. This overrides --pypath.`
		`- -pp, --pypath TEXT An absolute path to a Python executable to use when`
		`- creating a temporary virtual env.`
		`- -g, --global-packages Gives created virtual envs access to the global site-`
		`- packages.`
		`- -h, --help Show this message and exit.`
		`- .SH ENVIRONMENT`
		`+ .RI [ SHELL_NAME ]`
		`+ .RI [ SHELL_PATH ]`
		`+ .SH OPTIONS`
		`.TP`
		`- .B SHELL`
		`- Default shell name (or command)`
		`- .SH EXAMPLES`
		`- .SS ACTIVATION`
		`- .EX`
		`- .B $\ hatch\ env\ \-ll`
		- .B Virtual environments found in `/home/ofek/.virtualenvs`:
		`- .B \`
		`- .B fast \->`
		`- .B Version: 3.5.3`
		`- .B Implementation: PyPy`
		`- .B my-app \->`
		`- .B Version: 3.5.2`
		`- .B Implementation: CPython`
		`- .B old \->`
		`- .B Version: 2.7.12`
		`- .B Implementation: CPython`
		`- .B $\ which\ python`
		`- .B /usr/bin/python`
		`- .B $\ hatch\ shell\ my\-app`
		`- .B (my\-app)\ $\ which\ python`
		`- .B /home/ofek/.virtualenvs/my-app/bin/python`
		`- .EE`
		`- .SS COMMANDS`
		`- .EX`
		`- .B $\ hatch\ shell\ my\-app\ pip\ list\ \-\-format=columns`
		`- .B Package\ \ \ \ Version`
		`- .B \-\-\-\-\-\-\-\-\-\-\ \-\-\-\-\-\-\-`
		`- .B pip\ \ \ \ \ \ \ \ 9.0.1`
		`- .B setuptools\ 36.3.0`
		`- .B wheel\ \ \ \ \ \ 0.29.0`
		`- .B $\ hatch\ shell\ my\-app\ hatch\ install\ \-q\ requests\ six`
		`- .B $\ hatch\ shell\ my\-app\ pip\ list\ \-\-format=columns`
		`- .B Package\ \ \ \ Version`
		`- .B \-\-\-\-\-\-\-\-\-\-\ \-\-\-\-\-\-\-\-\-\-\-`
		`- .B certifi\ \ \ \ 2017.7.27.1`
		`- .B chardet\ \ \ \ 3.0.4`
		`- .B idna\ \ \ \ \ \ \ 2.6`
		`- .B pip\ \ \ \ \ \ \ \ 9.0.1`
		`- .B requests\ \ \ 2.18.4`
		`- .B setuptools\ 36.3.0`
		`- .B six\ \ \ \ \ \ \ \ 1.10.0`
		`- .B urllib3\ \ \ \ 1.22`
		`- .B wheel\ \ \ \ \ \ 0.29.0`
		`- .EE`
		`- .SS "TEMPORARY ENV"`
		`- .EX`
		`- .B $\ hatch\ shell\ \-t`
		`- .B Already using interpreter /usr/bin/python3`
		`- .B Using base prefix '/usr'`
		`- .B New python executable in /tmp/tmpzg73untp/Ihqd/bin/python3`
		`- .B Also creating executable in /tmp/tmpzg73untp/Ihqd/bin/python`
		`- .B Installing setuptools, pip, wheel...done.`
		`- .B $\ which\ python`
		`- .B /tmp/tmpzg73untp/Ihqd/bin/python`
		`- .EE`
		`+ .B \-h\fR, \fB\-\-help`
		`+ Show a help message and exit`
		`.SH "SEE ALSO"`
		`- .BR bash (1)`
		`- .P`
		`.BR hatch (1)`
		`- .P`
		`- .BR hatch\-build (1),`
		`- .BR hatch\-clean (1),`
		`- .BR hatch\-conda (1),`
		`- .BR hatch\-config (1),`
		`- .BR hatch\-env (1),`
		`- .BR hatch\-grow (1),`
		`- .BR hatch\-init (1),`
		`- .BR hatch\-install (1),`
		`- .BR hatch\-new (1),`
		`- .BR hatch\-pypath (1),`
		`- .BR hatch\-python (1),`
		`- .BR hatch\-release (1),`
		`- .BR hatch\-shed (1),`
		`- .\" .BR hatch\-shell (1),`
		`- .BR hatch\-test (1),`
		`- .BR hatch\-uninstall (1),`
		`- .BR hatch\-update (1)`

hatch-status.1

file added

+13

		`@@ -0,0 +1,13 @@`
		`+ .TH HATCH\-STATUS "1" "March 2022" "" "User Commands"`
		`+ .SH NAME`
		`+ .B hatch\ status`
		`+ \(en Show information about the current environment`
		`+ .SH SYNOPSIS`
		`+ .B hatch\ status`
		`+ .RI [ OPTIONS ]`
		`+ .SH OPTIONS`
		`+ .TP`
		`+ .B \-h\fR, \fB\-\-help`
		`+ Show a help message and exit`
		`+ .SH "SEE ALSO"`
		`+ .BR hatch (1)`

hatch-test.1

file removed

-146

		`@@ -1,146 +0,0 @@`
		`- .TH HATCH\-TEST "1" "Feburary 2022" "" "User Commands"`
		`- .SH NAME`
		`- .B hatch\ test`
		`- \(en Runs tests`
		`- .SH SYNOPSIS`
		`- .B hatch\ test`
		`- .RI [ OPTIONS ]`
		`- .RI [ PACKAGE ]`
		`- .SH DESCRIPTION`
		`- .P`
		`- Runs tests using`
		`- .BR pytest ,`
		`- optionally checking coverage.`
		`- .P`
		`- The path is derived in the following order:`
		`- .RS +7n`
		`- .IP 1. +3n`
		`- The optional argument, which should be`
		`- the name of a package that was installed via`
		`- .B hatch install \-l`
		`- or`
		`- .B pip install \-e\fR.`
		`- .IP 2. +3n`
		`- The`
		`- .B \-\-local`
		`- flag.`
		`- .IP 3. +3n`
		`- The option`
		`- .BR \-\-path ,`
		`- which can be a relative or absolute path.`
		`- .IP 4. +3n`
		`- The current directory.`
		`- .RE`
		`- .P`
		`- If the path points to a package, it should have a`
		`- .B tests`
		`- directory.`
		`- .P`
		`- If a project is detected but there is no dedicated virtual env,`
		`- it will be created and any dev requirements will be installed in it.`
		`- .SH OPTIONS`
		`- .TP`
		`- .B \-l\fR, \fB\-\-local`
		`- Shortcut to select the only available local (editable) package.`
		`- If there are multiple, an error will be raised.`
		`- .TP`
		`- .B \-p\fR, \fB\-\-path\ \fITEXT`
		`- A relative or absolute path to a project or test directory.`
		`- .TP`
		`- .B \-c\fR, \fB\-\-cov`
		`- Computes, then outputs coverage after testing.`
		`- .TP`
		`- .B \-m\fR, \fB\-\-merge`
		`- If`
		`- .BR \-\-cov ,`
		`- coverage will run using`
		`- .B \-\-parallel\-mode`
		`- and combine the results.`
		`- .TP`
		`- .B \-ta\fR, \fB\-\-test\-args\ \fITEXT`
		`- Pass through to`
		`- .BR pytest ,`
		`- overriding defaults.`
		`- .IP`
		`- Example:`
		`- .in +7n`
		`- .EX`
		`- .B hatch\ test\ \-ta\ "\-k\ test_core.py\ \-vv"`
		`- .EE`
		`- .in`
		`- .TP`
		`- .B \-ca\fR, \fB\-\-cov\-args\ \fITEXT`
		`- Pass through to`
		`- .BR coverage\ run ,`
		`- overriding defaults.`
		`- .IP`
		`- Example:`
		`- .in +7n`
		`- .EX`
		`- .B hatch\ test\ \-ca\ "\-\-timid\ \-\-pylib"`
		`- .EE`
		`- .in`
		`- .TP`
		`- .B \-g\fR, \fB\-\-global`
		`- Uses the`
		`- .B pytest`
		`- and`
		`- .B coverage`
		`- shipped with Hatch instead of environment-aware modules.`
		`- This is useful if you just want to run a quick test`
		`- without installing these again in a virtual env.`
		`- Keep in mind these will be the Python 3 versions.`
		`- .TP`
		`- .B \-nd\fR, \fB\-\-no\-detect`
		`- Does not run the tests inside a project\(cqs dedicated virtual env.`
		`- .TP`
		`- .B \-h\fR, \fB\-\-help`
		`- Show a help message and exit.`
		`- .SH EXAMPLES`
		`- .in +7n`
		`- .EX`
		`- .B $\ git\ clone\ https://github.com/ofek/privy\ &&\ cd\ privy`
		`- .B $\ hatch\ test\ -c`
		`- .B =========================\ test\ session\ starts\ ==========================`
		`- .B platform\ linux\ --\ Python\ 3.5.2,\ pytest-3.2.1,\ py-1.4.34,\ pluggy-0.4.0`
		`- .B rootdir:\ /home/ofek/privy,\ inifile:`
		`- .B plugins:\ xdist-1.20.0,\ mock-1.6.2,\ httpbin-0.0.7,\ forked-0.2,\ cov-2.5.1`
		`- .B collected\ 10\ items`
		`- .B \`
		`- .B tests/test_privy.py\ ..........`
		`- .B`
		`- .B ======================\ 10\ passed\ in\ 4.34\ seconds\ =======================`
		`- .B \`
		`- .B Tests\ completed,\ checking\ coverage...`
		`- .B \`
		`- .B Name\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ Stmts\ \ \ Miss\ Branch\ BrPart\ \ Cover\ \ \ Missing`
		`- .B -----------------------------------------------------------------`
		`- .B privy/__init__.py\ \ \ \ \ \ \ \ \ 1\ \ \ \ \ \ 0\ \ \ \ \ \ 0\ \ \ \ \ \ 0\ \ \ 100%`
		`- .B privy/core.py\ \ \ \ \ \ \ \ \ \ \ \ 30\ \ \ \ \ \ 0\ \ \ \ \ \ 0\ \ \ \ \ \ 0\ \ \ 100%`
		`- .B privy/utils.py\ \ \ \ \ \ \ \ \ \ \ 13\ \ \ \ \ \ 0\ \ \ \ \ \ 4\ \ \ \ \ \ 0\ \ \ 100%`
		`- .B tests/__init__.py\ \ \ \ \ \ \ \ \ 0\ \ \ \ \ \ 0\ \ \ \ \ \ 0\ \ \ \ \ \ 0\ \ \ 100%`
		`- .B tests/test_privy.py\ \ \ \ \ \ 57\ \ \ \ \ \ 0\ \ \ \ \ \ 0\ \ \ \ \ \ 0\ \ \ 100%`
		`- .B -----------------------------------------------------------------`
		`- .B TOTAL\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ 101\ \ \ \ \ \ 0\ \ \ \ \ \ 4\ \ \ \ \ \ 0\ \ \ 100%`
		`- .EE`
		`- .in`
		`- .SH "SEE ALSO"`
		`- .BR hatch (1)`
		`- .P`
		`- .BR hatch\-build (1),`
		`- .BR hatch\-clean (1),`
		`- .BR hatch\-conda (1),`
		`- .BR hatch\-config (1),`
		`- .BR hatch\-env (1),`
		`- .BR hatch\-grow (1),`
		`- .BR hatch\-init (1),`
		`- .BR hatch\-install (1),`
		`- .BR hatch\-new (1),`
		`- .BR hatch\-pypath (1),`
		`- .BR hatch\-python (1),`
		`- .BR hatch\-release (1),`
		`- .BR hatch\-shed (1),`
		`- .BR hatch\-shell (1),`
		`- .\" .BR hatch\-test (1),`
		`- .BR hatch\-uninstall (1),`
		`- .BR hatch\-update (1)`

hatch-uninstall.1

file removed

-91

		`@@ -1,91 +0,0 @@`
		`- .TH HATCH\-UNINSTALL "1" "Feburary 2022" "" "User Commands"`
		`- .SH NAME`
		`- .B hatch\ uninstall`
		`- \(en Uninstalls packages`
		`- .SH SYNOPSIS`
		`- .B hatch\ uninstall`
		`- .RI [ OPTIONS ]`
		`- .RI [ PACKAGES ]...`
		`- .SH DESCRIPTION`
		`- .P`
		`- If the option`
		`- .B \-\-env`
		`- is supplied, the uninstall will be applied using that named virtual env.`
		`- Unless the option`
		`- .B \-\-global`
		`- is selected, the uninstall will only affect the current user.`
		`- Of course, this will have no effect if a virtual env is in use.`
		`- The desired name of the admin user can be set with the`
		`- .B _DEFAULT_ADMIN_`
		`- environment variable.`
		`- .P`
		`- With no packages selected, this will uninstall using a`
		`- .B requirements.txt`
		`- or a dev version of that in the current directory.`
		`- .P`
		`- If no`
		`- .B \-\-env`
		`- is chosen, this will attempt to detect a project and use its`
		`- virtual env before resorting to the default`
		`- .BR pip (1).`
		`- No project detection will occur if a virtual env is active.`
		`- .SH OPTIONS`
		`- .TP`
		`- .B \-nd\fR, \fB\-\-no\-detect`
		`- Disables the use of a project\(cqs dedicated virtual env.`
		`- This is useful if you need to be in a project root but`
		`- wish to not target its virtual env.`
		`- .TP`
		`- .B \-e\fR, \fB\-\-env\ \fITEXT`
		`- The named virtual env to use.`
		`- .TP`
		`- .B \-g\fR, \fB\-\-global`
		`- Uninstalls globally, rather than on a per-user basis.`
		`- This has no effect if a virtual env is in use.`
		`- .TP`
		`- .B \-\-admin`
		`- When`
		`- .B \-\-global`
		`- is selected, this assumes admin rights are`
		`- already enabled and therefore`
		`- .BR sudo (8)/runas`
		`- will not be used.`
		`- .TP`
		`- .B \-d\fR, \fB\-\-dev`
		`- When locating a requirements file, only use the dev version.`
		`- .TP`
		`- .B \-q\fR, \fB\-\-quiet`
		`- Decreases verbosity.`
		`- .TP`
		`- .B \-y\fR, \fB\-\-yes`
		`- Confirms the intent to uninstall without a prompt.`
		`- .TP`
		`- .B \-h\fR, \fB\-\-help`
		`- Show a help message and exit.`
		`- .SH ENVIRONMENT`
		`- .TP`
		`- .B _DEFAULT_ADMIN_`
		`- Desired name of the admin user`
		`- .SH "SEE ALSO"`
		`- .BR pip (1) ,`
		`- .BR sudo (8)`
		`- .P`
		`- .BR hatch (1)`
		`- .P`
		`- .BR hatch\-build (1),`
		`- .BR hatch\-clean (1),`
		`- .BR hatch\-conda (1),`
		`- .BR hatch\-config (1),`
		`- .BR hatch\-env (1),`
		`- .BR hatch\-grow (1),`
		`- .BR hatch\-init (1),`
		`- .BR hatch\-install (1),`
		`- .BR hatch\-new (1),`
		`- .BR hatch\-pypath (1),`
		`- .BR hatch\-python (1),`
		`- .BR hatch\-release (1),`
		`- .BR hatch\-shed (1),`
		`- .BR hatch\-shell (1),`
		`- .BR hatch\-test (1),`
		`- .\" .BR hatch\-uninstall (1),`
		`- .BR hatch\-update (1)`

hatch-update.1

file removed

-140

		`@@ -1,140 +0,0 @@`
		`- .TH HATCH\-UPDATE "1" "Feburary 2022" "" "User Commands"`
		`- .SH NAME`
		`- .B hatch\ update`
		`- \(en Updates packages`
		`- .SH SYNOPSIS`
		`- .B hatch\ update`
		`- .RI [ OPTIONS ]`
		`- .RI [ PACKAGES ]...`
		`- .SH DESCRIPTION`
		`- .P`
		`- If the option`
		`- .B \-\-env`
		`- is supplied, the update will be applied using that named virtual env.`
		`- Unless the option`
		`- .B \-\-global`
		`- is selected, the update will only affect the current user.`
		`- Of course, this will have no effect if a virtual env is in use.`
		`- The desired name of the admin user can be set with the`
		`- .B _DEFAULT_ADMIN_`
		`- environment variable.`
		`- .P`
		`- When performing a global update,`
		`- your system may use an older version of pip`
		`- that is incompatible with some features such as`
		`- .BR \-\-eager .`
		`- To force the use of these features, use`
		`- .BR \-\-force .`
		`- .P`
		`- With no packages nor options selected,`
		`- this will update packages by looking for a`
		`- .B requirements.txt`
		`- or a dev version of that in the current directory.`
		`- .P`
		`- If no`
		`- .B \-\-env`
		`- is chosen, this will attempt to detect a project`
		`- and use its virtual env before resorting to the default`
		`- .BR pip (1).`
		`- No project detection will occur if a virtual env is active.`
		`- .P`
		`- To update this tool, use the`
		`- .B \-\-self`
		`- flag.`
		`- All other methods of updating will ignore`
		`- .BR hatch .`
		`- See:`
		`- .UR https://github.com/pypa/pip/issues/1299`
		`- .UE`
		`- .SH OPTIONS`
		`- .TP`
		`- .B \-nd\fR, \fB\-\-no\-detect`
		`- Disables the use of a project\(cqs dedicated virtual env.`
		`- This is useful if you need to be in a project root but`
		`- wish to not target its virtual env.`
		`- .TP`
		`- .B \-e\fR, \fB\-\-env\ \fITEXT`
		`- The named virtual env to use.`
		`- .TP`
		`- .B \-\-eager`
		`- Updates all dependencies regardless of whether they still`
		`- satisfy the new parent requirements.`
		`- See:`
		`- .UR https://github.com/pypa/pip/pull/3972`
		`- .UE`
		`- .TP`
		`- .B \-\-all`
		`- Updates all currently installed packages.`
		`- The packages`
		`- .BR pip ,`
		`- .BR setuptools ,`
		`- and`
		`- .B wheel`
		`- are excluded.`
		`- .TP`
		`- .B \-\-infra`
		`- Updates only the packages`
		`- .BR pip ,`
		`- .BR setuptools ,`
		`- and`
		`- .BR wheel .`
		`- .TP`
		`- .B \-g\fR, \fB\-\-global`
		`- Updates globally, rather than on a per-user basis.`
		`- This has no effect if a virtual env is in use.`
		`- .TP`
		`- .B \-\-admin`
		`- When`
		`- .B \-\-global`
		`- is selected, this assumes admin rights are already enabled and therefore`
		`- .BR sudo (8)/runas`
		`- will not be used.`
		`- .TP`
		`- .B \-f\fR, \fB\-\-force`
		`- Forces the use of newer features in global updates.`
		`- .TP`
		`- .B \-d\fR, \fB\-\-dev`
		`- When locating a requirements file, only use the dev version.`
		`- .TP`
		`- .B \-m\fR, \fB\-\-module`
		`- Invokes`
		`- .BR pip (1)`
		`- as a module instead of directly, i.e. \fBpython\ \-m\ pip\fR.`
		`- .TP`
		`- .B \-\-self`
		`- Updates`
		`- .BR hatch (1)`
		`- itself.`
		`- .TP`
		`- .B \-q\fR, \fB\-\-quiet`
		`- Decreases verbosity.`
		`- .TP`
		`- .B \-h\fR, \fB\-\-help`
		`- Show a help message and exit.`
		`- .SH ENVIRONMENT`
		`- .TP`
		`- .B _DEFAULT_ADMIN_`
		`- Desired name of the admin user`
		`- .SH "SEE ALSO"`
		`- .BR pip (1) ,`
		`- .BR sudo (8)`
		`- .P`
		`- .BR hatch (1)`
		`- .P`
		`- .BR hatch\-build (1),`
		`- .BR hatch\-clean (1),`
		`- .BR hatch\-conda (1),`
		`- .BR hatch\-config (1),`
		`- .BR hatch\-env (1),`
		`- .BR hatch\-grow (1),`
		`- .BR hatch\-init (1),`
		`- .BR hatch\-install (1),`
		`- .BR hatch\-new (1),`
		`- .BR hatch\-pypath (1),`
		`- .BR hatch\-python (1),`
		`- .BR hatch\-release (1),`
		`- .BR hatch\-shed (1),`
		`- .BR hatch\-shell (1),`
		`- .BR hatch\-test (1),`
		`- .BR hatch\-uninstall (1)`
		`- .\" .BR hatch\-update (1)`

hatch-use.1

file removed

-16

		`@@ -1,16 +0,0 @@`
		`- .TH HATCH\-USE "1" "Feburary 2022" "" "User Commands"`
		`- .SH NAME`
		`- .B hatch\ use`
		`- \(en Activates or sends a command to a virtual environment`
		`- .SH SYNOPSIS`
		`- .B hatch\ use`
		`- .RI [ OPTIONS ]`
		`- .RI [ ENV_NAME ]`
		`- .RI [ COMMAND ]...`
		`- .SH DESCRIPTION`
		`- .P`
		`- This is an alias for`
		`- .BR hatch\-shell (1).`
		`- See its documentation for further details.`
		`- .SH "SEE ALSO"`
		`- .BR hatch\-shell (1)`

hatch-version.1

file added

+13

		`@@ -0,0 +1,13 @@`
		`+ .TH HATCH\-VERSION "1" "March 2022" "" "User Commands"`
		`+ .SH NAME`
		`+ .B hatch\ version`
		`+ \(en View or set a project\(cqs version`
		`+ .SH SYNOPSIS`
		`+ .B hatch\ version`
		`+ .RI [ OPTIONS ]`
		`+ .SH OPTIONS`
		`+ .TP`
		`+ .B \-h\fR, \fB\-\-help`
		`+ Show a help message and exit`
		`+ .SH "SEE ALSO"`
		`+ .BR hatch (1)`

hatch.1

file modified

+143 -78

		`@@ -1,4 +1,4 @@`
		`- .TH HATCH "1" "Feburary 2022" "" "User Commands"`
		`+ .TH HATCH "1" "March 2022" "" "User Commands"`
		`.SH NAME`
		`.B hatch`
		`\(en A modern project, package, and virtual env manager`
		`@@ -9,129 +9,194 @@`
		`.RI [ ARGS ]...`
		`.SH OPTIONS`
		`.TP`
		`+ .B \-e\fR,\ \fB\-\-env\ \fITEXT`
		`+ The name of the environment to use`
		`+ [env var:`
		`+ .BR HATCH_ENV ]`
		`+ .TP`
		`+ .B \-p\fR,\ \fB\-\-project\ \fITEXT`
		`+ The name of the project to work on`
		`+ [env var:`
		`+ .BR HATCH_PROJECT ]`
		`+ .TP`
		`+ .B \-\-color\fR,\ / \fB\-\-no\-color`
		`+ Whether or not to display colored output`
		`+ (default is auto-detection)`
		`+ [env vars:`
		`+ .BR FORCE_COLOR / NO_COLOR ]`
		`+ .TP`
		`+ .B \-\-interactive\fR,\ / \fB\-\-no\-interactive`
		`+ Whether or not to allow features like prompts and progress bars`
		`+ (default is auto-detection)`
		`+ [env var:`
		`+ .BR HATCH_INTERACTIVE ]`
		`+ .TP`
		`+ .B \-v\fR,\ \fB\-\-verbose`
		`+ Increase verbosity`
		`+ (can be used additively)`
		`+ [env var:`
		`+ .BR HATCH_VERBOSE ]`
		`+ .TP`
		`+ .B \-q\fR,\ \fB\-\-quiet`
		`+ Decrease verbosity`
		`+ (can be used additively)`
		`+ [env var:`
		`+ .BR HATCH_QUIET ]`
		`+ .TP`
		`+ .B \-\-data\-dir\ \fITEXT`
		`+ The path to a custom directory used to persist data`
		`+ [env var:`
		`+ .BR HATCH_DATA_DIR ]`
		`+ .TP`
		`+ .B \-\-cache\-dir\ \fITEXT`
		`+ The path to a custom directory used to cache data`
		`+ [env var:`
		`+ .BR HATCH_CACHE_DIR ]`
		`+ .TP`
		`+ .B \-\-config\ \fITEXT`
		`+ The path to a custom config file to use`
		`+ [env var:`
		`+ .BR HATCH_CONFIG ]`
		`+ .TP`
		`.B \-\-version`
		`- show the version and exit`
		`+ Show the version and exit.`
		`.TP`
		`.B \-h\fR,\ \fB\-\-help`
		`- show a help message and exit`
		`+ Show a help message and exit.`
		`.SS "COMMANDS"`
		`.TP`
		`.B build`
		`- Builds a project`
		`+ Build a project`
		`.IP`
		`See`
		`.BR hatch\-build (1).`
		`.TP`
		`.B clean`
		`- Removes a project\(cqs build artifacts`
		`+ Remove build artifacts`
		`.IP`
		`See`
		`.BR hatch\-clean (1).`
		`.TP`
		`- .B conda`
		`- Installs Miniconda`
		`- .IP`
		`- See`
		`- .BR hatch\-conda (1).`
		`- .TP`
		`.B config`
		`- Locates, updates, or restores the config file`
		`+ Manage the config file`
		`.IP`
		`See`
		`.BR hatch\-config (1).`
		`.TP`
		`- .B env`
		`- Manages virtual environments`
		`- .IP`
		`- See`
		`- .BR hatch\-env (1).`
		`- .TP`
		`- .B grow`
		`- Increments a project\(cqs version`
		`+ .B dep`
		`+ Manage environment dependencies`
		`.IP`
		`See`
		`- .BR hatch\-grow (1).`
		`+ .BR hatch\-dep (1).`
		`.TP`
		`- .B init`
		`- Creates a new Python project in the current directory`
		`- .IP`
		`- See`
		`- .BR hatch\-init (1).`
		`- .TP`
		`- .B install`
		`- Installs packages`
		`+ .B env`
		`+ Manage project environments`
		`.IP`
		`See`
		`- .BR hatch\-install (1).`
		`+ .BR hatch\-env (1).`
		`.TP`
		`.B new`
		`- Creates a new Python project`
		`+ Create or initialize a project`
		`.IP`
		`See`
		`.BR hatch\-new (1).`
		`.TP`
		`- .B pypath`
		`- Manages named Python paths`
		`+ .B publish`
		`+ Publish build artifacts`
		`.IP`
		`See`
		`- .BR hatch\-pypath (1).`
		`+ .BR hatch\-publish (1).`
		`.TP`
		`- .B python`
		`- Manages Python installations`
		`+ .B run`
		`+ Run commands within project environments`
		`.IP`
		`See`
		`- .BR hatch\-python (1).`
		`- .TP`
		`- .B release`
		`- Uploads to PyPI`
		`- .IP`
		`- See`
		`- .BR hatch\-release (1).`
		`- .TP`
		`- .B shed`
		`- Removes named Python paths or virtual environments`
		`- .IP`
		`- See`
		`- .BR hatch\-shed (1).`
		`+ .BR hatch\-run (1).`
		`.TP`
		`.B shell`
		`- Activates or sends a command to a virtual environment`
		`+ Enter a shell within a project\(cqs environment`
		`.IP`
		`See`
		`.BR hatch\-shell (1).`
		`.TP`
		`- .B test`
		`- Runs tests`
		`- .IP`
		`- See`
		`- .BR hatch\-test (1).`
		`- .TP`
		`- .B uninstall`
		`- Uninstalls packages`
		`- .IP`
		`- See`
		`- .BR hatch\-uninstall (1).`
		`- .TP`
		`- .B update`
		`- Updates packages`
		`- .IP`
		`- See`
		`- .BR hatch\-update (1).`
		`+ .B status`
		`+ Show information about the current environment`
		`+ .IP`
		`+ See`
		`+ .BR hatch\-status (1).`
		`+ .TP`
		`+ .B version`
		`+ View or set a project\(cqs version`
		`+ .IP`
		`+ See`
		`+ .BR hatch\-version (1).`
		`+ .SH ENVIRONMENT`
		`+ .TP`
		`+ .B HATCH_ENV`
		`+ The name of the environment to use`
		`+ [option:`
		`+ .BR \-e ,`
		`+ .BR \-\-env ]`
		`+ .TP`
		`+ .B HATCH_PROJECT`
		`+ The name of the project to work on`
		`+ [option:`
		`+ .BR \-p ,`
		`+ .BR \-\-project ]`
		`+ .TP`
		`+ .B FORCE_COLOR`
		`+ Display colored output`
		`+ (default is auto-detection)`
		`+ [option:`
		`+ .BR \-\-color ]`
		`+ .TP`
		`+ .B NO_COLOR`
		`+ Do not display colored output`
		`+ (default is auto-detection)`
		`+ [option:`
		`+ .BR \-\-no\-color ]`
		`+ .TP`
		`+ .B HATCH_INTERACTIVE`
		`+ Whether or not to allow features like prompts and progress bars`
		`+ (default is auto-detection)`
		`+ [options:`
		`+ .BR \-\-interactive / \-\-no\-interactive ]`
		`+ .TP`
		`+ .B HATCH_VERBOSE`
		`+ Increase verbosity`
		`+ [option:`
		`+ .BR \-v ,`
		`+ .BR \-\-verbose ]`
		`+ .TP`
		`+ .B HATCH_QUIET`
		`+ Decrease verbosity`
		`+ [option:`
		`+ .BR \-q ,`
		`+ .BR \-\-quiet ]`
		`+ .TP`
		`+ .B HATCH_DATA_DIR`
		`+ The path to a custom directory used to persist data`
		`+ [option:`
		`+ .BR \-\-data\-dir ]`
		`+ .TP`
		`+ .B HATCH_CACHE_DIR`
		`+ The path to a custom directory used to acahe data`
		`+ [option:`
		`+ .BR \-\-cache\-dir ]`
		`+ .TP`
		`+ .B HATCH_CONFIG`
		`+ The path to a custom custom config file to use`
		`+ [option:`
		`+ .BR \-\-config ]`
		`.SH "SEE ALSO"`
		`.BR hatch\-build (1),`
		`.BR hatch\-clean (1),`
		`- .BR hatch\-conda (1),`
		`.BR hatch\-config (1),`
		`+ .BR hatch\-dep (1),`
		`.BR hatch\-env (1),`
		`- .BR hatch\-grow (1),`
		`- .BR hatch\-init (1),`
		`- .BR hatch\-install (1),`
		`.BR hatch\-new (1),`
		`- .BR hatch\-pypath (1),`
		`- .BR hatch\-python (1),`
		`- .BR hatch\-release (1),`
		`- .BR hatch\-shed (1),`
		`+ .BR hatch\-publish (1),`
		`+ .BR hatch\-run (1),`
		`.BR hatch\-shell (1),`
		`- .BR hatch\-test (1),`
		`- .BR hatch\-uninstall (1),`
		`- .BR hatch\-update (1)`
		`+ .BR hatch\-status (1),`
		`+ .BR hatch\-version (1)`

hatch.spec

file modified

+79 -68

		`@@ -1,45 +1,50 @@`
		`- # Need to use GitHub archive for tests. This version was not tagged.`
		`- %global commit 804d5fd902809bae19e72a50917bd90ab032e174`
		`- %global forgeurl https://github.com/ofek/hatch`
		`+ %bcond_without tests`

		`Name: hatch`
		`- Version: 0.23.1`
		`- %forgemeta`
		`+ Version: 1.0.0`
		`Release: %autorelease`
		`Summary: A modern project, package, and virtual env manager`

		`- License: MIT or ASL 2.0`
		`- URL: %{forgeurl}`
		`- Source0: %{forgesource}`
		`+ License: MIT`
		`+ URL: https://github.com/ofek/hatch`
		`+ %global tag hatch-v%{version}`
		`+ Source0: %{url}/archive/%{tag}/hatch-%{version}.tar.gz`
		`+ # For now, we need a helper script to access environments defined with`
		`+ # hatch/hatchling (https://ofek.dev/hatch/latest/config/environment/).`
		`+ Source1: extract-hatchling-environments`

		`# Written for Fedora in groff_man(7) format based on --help output`
		`Source100: hatch.1`
		`- Source101: hatch-build.1`
		`- Source102: hatch-clean.1`
		`- Source103: hatch-conda.1`
		`- Source104: hatch-config.1`
		`- Source105: hatch-env.1`
		`- Source106: hatch-grow.1`
		`- Source107: hatch-init.1`
		`- Source108: hatch-install.1`
		`- Source109: hatch-new.1`
		`- Source110: hatch-pypath.1`
		`- Source111: hatch-python.1`
		`- Source112: hatch-release.1`
		`- Source113: hatch-shed.1`
		`- Source114: hatch-shell.1`
		`- Source115: hatch-test.1`
		`- Source116: hatch-use.1`
		`- Source117: hatch-uninstall.1`
		`- Source118: hatch-update.1`
		`+ Source200: hatch-build.1`
		`+ Source300: hatch-clean.1`
		`+ Source400: hatch-config.1`
		`+ Source401: hatch-config-explore.1`
		`+ Source402: hatch-config-find.1`
		`+ Source403: hatch-config-restore.1`
		`+ Source404: hatch-config-set.1`
		`+ Source405: hatch-config-show.1`
		`+ Source406: hatch-config-update.1`
		`+ Source500: hatch-dep.1`
		`+ Source501: hatch-dep-hash.1`
		`+ Source510: hatch-dep-show.1`
		`+ Source511: hatch-dep-show-table.1`
		`+ Source600: hatch-env.1`
		`+ Source700: hatch-new.1`
		`+ Source800: hatch-publish.1`
		`+ Source900: hatch-run.1`
		`+ Source1000: hatch-shell.1`
		`+ Source1100: hatch-status.1`
		`+ Source1200: hatch-version.1`

		`BuildArch: noarch`

		`BuildRequires: python3-devel`
		`+ # RHBZ#1985340, RHBZ#2076994`
		`+ BuildRequires: pyproject-rpm-macros >= 1.2.0`
		`BuildRequires: git-core`

		`- # Required for tests but not present in the package metadata:`
		`- BuildRequires: python3dist(parse)`
		`+ # For script in %%generate_buildrequires:`
		`+ BuildRequires: python3dist(tomli)`

		`Requires: git-core`

		`@@ -48,67 +53,73 @@`

		`Features:`

		`- · Standardized build system with reproducible builds by default`
		`- · Robust environment management with support for custom scripts`
		`- · Easy publishing to PyPI or other sources`
		`- · Version management`
		`- · Configurable project generation with sane defaults`
		`- · Responsive CLI, ~2-3x faster than equivalent tools`
		`+ • Standardized build system with reproducible builds by default`
		`+ • Robust environment management with support for custom scripts`
		`+ • Easy publishing to PyPI or other sources`
		`+ • Version management`
		`+ • Configurable project generation with sane defaults`
		`+ • Responsive CLI, ~2-3x faster than equivalent tools`


		`%prep`
		`- %forgeautosetup`
		`- cp -p '%{SOURCE100}' '%{SOURCE101}' '%{SOURCE102}' '%{SOURCE103}' \`
		`- '%{SOURCE104}' '%{SOURCE105}' '%{SOURCE106}' '%{SOURCE107}' \`
		`- '%{SOURCE108}' '%{SOURCE109}' '%{SOURCE110}' '%{SOURCE111}' \`
		`- '%{SOURCE112}' '%{SOURCE113}' '%{SOURCE114}' '%{SOURCE115}' \`
		`- '%{SOURCE116}' '%{SOURCE117}' '%{SOURCE118}' .`
		`+ %autosetup -n hatch-%{tag} -p1`
		`+`
		`+ # Loosen version requirements that cannot yet be met in Fedora.`
		`+`
		`+ # https://bugzilla.redhat.com/show_bug.cgi?id=1887119`
		`+ sed -r -i 's/("pyperclip>=)1\.8\.2"/\11\.8\.0"/' pyproject.toml`


		`%generate_buildrequires`
		`- %pyproject_buildrequires`
		`+ '%{SOURCE1}' -v`
		`+ %pyproject_buildrequires -w %{?with_tests:_req/env.test.txt}`


		`%build`
		`%pyproject_wheel`

		`+ # The Markdown documentation is meant to be built with mkdocs. The HTML result`
		`+ # is unsuitable for packaging due to various bundled and pre-minified`
		`+ # JavaScript and CSS. See https://bugzilla.redhat.com/show_bug.cgi?id=2006555`
		`+ # for discussion of similar problems with Sphinx and Doxygen. We therefore do`
		`+ # not build or install the documentation.`
		`+`

		`%install`
		`%pyproject_install`
		`%pyproject_save_files hatch`
		`- install -t '%{buildroot}%{_mandir}/man1' -D -p -m 0644 hatch.1 hatch-*.1`
		`+`
		`+ install -t '%{buildroot}%{_mandir}/man1' -D -p -m 0644 \`
		`+ '%{SOURCE100}' \`
		`+ '%{SOURCE200}' \`
		`+ '%{SOURCE300}' \`
		`+ '%{SOURCE400}' '%{SOURCE401}' '%{SOURCE402}' '%{SOURCE403}' \`
		`+ '%{SOURCE404}' '%{SOURCE405}' '%{SOURCE406}' \`
		`+ '%{SOURCE500}' '%{SOURCE501}' '%{SOURCE510}' '%{SOURCE511}' \`
		`+ '%{SOURCE600}' \`
		`+ '%{SOURCE700}' \`
		`+ '%{SOURCE800}' \`
		`+ '%{SOURCE900}' \`
		`+ '%{SOURCE1000}' \`
		`+ '%{SOURCE1100}' \`
		`+ '%{SOURCE1200}'`


		`%check`
		`- # test_download_file needs internet`
		`- k="${k-}${k+ and }not test_download_file"`
		`- # test_env timeouts (on its own limit) in Koji`
		`- k="${k-}${k+ and }not test_env"`
		`- # test_grow is not compatible with the latest click:`
		`- # https://github.com/ofek/hatch/issues/99 (fixed for 1.0)`
		`- k="${k-}${k+ and }not test_grow"`
		`- # > assert parsed['coverage_command'] == '\n\nafter_success:\n - codecov'`
		`- # E AssertionError: assert '\n\nafter_su... - codecov\n' == '\n\nafter_su...\n - codecov'`
		`- # E`
		`- # E`
		`- # E after_success:`
		`- # E - - codecov`
		`- # E + - codecov`
		`- # E ? +`
		`- # TODO: what exactly is happening here? Adding a BR on python3dist(codecov)`
		`- # doesn’t make a difference.`
		`- k="${k-}${k+ and }not test_coverage_command"`
		`-`
		`- %pytest -k "${k-}"`
		`+ %if %{with tests}`
		`+ # We ignore “tests/backend” because these belong to the “hatchling” package and`
		`+ # are run when we build the python-hatchling RPM.`
		`+ #`
		`+ # There is no need to deselect mark “requires_internet” manually because it`
		`+ # happens automagically via a runtime connectivity check.`
		`+ %pytest --ignore='tests/backend' -k "${k-}" -vv`
		`+ %else`
		`+ %pyproject_check_import`
		`+ %endif`


		`%files -f %{pyproject_files}`
		`- # pyproject_files handles LICENSE-* and AUTHORS.rst; verify with “rpm -qL -p …”`
		`- %doc COMMANDS.rst`
		`- %doc CONFIG.rst`
		`- %doc HISTORY.rst`
		`- %doc README.rst`
		`-`
		`+ %license LICENSE.txt`
		`%{_bindir}/hatch`
		`%{_mandir}/man1/hatch.1*`
		`%{_mandir}/man1/hatch-.1`

sources

file modified

+1 -1

		`@@ -1,1 +1,1 @@`
		`- SHA512 (hatch-804d5fd902809bae19e72a50917bd90ab032e174.tar.gz) = 54ecde92d3d20547a0b9a31e6a96fce198c79c1add2e7d1b9cc0aa4baf7fbdfcf500d4c0e1b165e08785fd7dfff2df0e02dd45c5dca078a21d3ce1826f130f65`
		`+ SHA512 (hatch-1.0.0.tar.gz) = c099b2c5bbb79d2d57996a99bd0df7b0f6b585b2b764c5f2a4a0d076b0e2909bbb9a0e5a2b92d7214bcbc4b3428f9817b4bfa46ddd65d043d4f0fcf973f83024`

rpms / hatch

#1 Update to 1.0.0

Merged 2 years ago by music. Opened 2 years ago by music.

rpms/ music/hatch v1 into rawhide

Metadata

Changes Summary 42

rpms / hatch

Source Code

#1 Update to 1.0.0 Merged 2 years ago by music. Opened 2 years ago by music. rpms/ music/hatch v1 into rawhide

Metadata

Changes Summary 42

#1 Update to 1.0.0

Merged 2 years ago by music. Opened 2 years ago by music.

rpms/ music/hatch v1 into rawhide