Make single-file builds of Python tools using zapp, shiv, or pex.

Binary distributions:

• https://pypi.org/project/toolmaker/

Source code:

• https://gitlab.com/sinoroc/toolmaker
• https://github.com/sinoroc/toolmaker

$ toolmaker --help
usage: toolmaker [-h] [--version] [--config CONFIG]
 [--build | --rebuild | --delete] [--all]
 [tool [tool ...]]
Make single-file builds of Python tools using zapp, shiv, or pex
positional arguments:
 tool apply action on this tool(s)
optional arguments:
 -h, --help show this help message and exit
 --version show program's version number and exit
 --config CONFIG, -c CONFIG
 configuration file (default:
 /home/sinoroc/.config/toolmaker/toolmaker.cfg)
 --build, -b build selected tool(s)
 --rebuild, -r rebuild selected tool(s)
 --delete, -d delete selected tool(s)
 --all, -a apply action on all tools

By default this tool looks for a configuration file at the following location:

• ${HOME}/.config/toolmaker/toolmaker.cfg on Linux
• %USERPROFILE%\AppData\Roaming\toolmaker\toolmaker.cfg on Windows

[toolmaker.tool.defaults]
tools_directory = ~/.local/bin/.toolmaker
[toolmaker.tool.zapp:deptree]
entry_point = deptree.cli:main
requirements =
 deptree
[toolmaker.tool.pex:http]
entry_point = http.server
[toolmaker.tool.shiv:shiv]
entry_point = shiv.cli:main
requirements =
 shiv
[toolmaker.tool.zapp:something]
entry_point = something.cli:main
requirements =
 --no-index
 SomeRandomProject --find-links /path/to/location
requirements_txts =
 requirements.txt
 more.txt

The action can be specified on the command line. Either one of:

• --build, -b to build (already existing tools are skipped);
• --rebuild, -r to rebuild (already existing tools are rebuilt);
• --delete, -d to delete (tool target file is deleted if it exists, then its parent directory is deleted if it is empty).

The default action when no flag is specified is to build the tools.

[toolmaker.tool.defaults]
tools_directory =
tool_directory =
[toolmaker.tool.zapp:foo]
# ./foo
[toolmaker.tool.zapp:bar]
# ./bar

[toolmaker.tool.defaults]
tools_directory = /somewhere
tool_directory =
[toolmaker.tool.zapp:foo]
# /somewhere/foo
[toolmaker.tool.zapp:bar]
# /somewhere/bar

[toolmaker.tool.defaults]
tools_directory = /somewhere
[toolmaker.tool.zapp:foo0]
# /somewhere/foo0/foo0
[toolmaker.tool.zapp:foo1]
tool_directory = foo0
# /somewhere/foo0/foo1
[toolmaker.tool.zapp:foo2]
# /somewhere/foo2/foo2
[toolmaker.tool.zapp:foo3]
tool_file = foo0
# /somewhere/foo3/foo0

To use in combination with GNU Stow:

[toolmaker.tool.defaults]
tools_directory = ~/.local/bin/.toolmaker
[toolmaker.tool.zapp:foo0]
# ~/.local/bin/.toolmaker/foo0/foo0
[toolmaker.tool.zapp:foo1]
tool_directory = foo0
# ~/.local/bin/.toolmaker/foo0/foo1
[toolmaker.tool.zapp:foo2]
# ~/.local/bin/.toolmaker/foo2/foo2
[toolmaker.tool.zapp:foo3]
tool_file = foo0
# ~/.local/bin/.toolmaker/foo3/foo0

• pickley
• pipx
• Zapper