vmklib (2.0.5)
Simplify project workflows by standardizing use of GNU Make.
- By sphinx-apidoc
(What's
sphinx-apidoc?) - By pydoc
(What's
pydoc?)
This package is tested with the following Python minor versions:
This package is tested on the following platforms:
ubuntu-latestmacos-latestwindows-latest
This tool integrates with existing Makefile's with zero additional
content or bootstrapping required.
There are many choices in technology or products for performing static analysis on source code, building test infrastructure, or managing local development environments. These are only a small subset of common, developer tasks when building software. This package intends to aggregate recipes (and their dependency relationships) for these tasks so that they can be integrated into a project without re-building this infrastructure. Lessons learned and improvements in each project can be back-propagated everywhere else with simple package updates.
$ ./venv3.12/bin/mk -h
usage: mk [-h] [--version] [-v] [-q] [--curses] [--no-uvloop] [-C DIR]
[-p PREFIX] [-d] [-D DEFAULT] [-f FILE] [-c CONFIG] [-P PROJ]
[targets ...]
Simplify project workflows by standardizing use of GNU Make.
positional arguments:
targets targets to execute
options:
-h, --help show this help message and exit
--version show program's version number and exit
-v, --verbose set to increase logging verbosity
-q, --quiet set to reduce output
--curses whether or not to use curses.wrapper when starting
--no-uvloop whether or not to disable uvloop as event loop driver
-C DIR, --dir DIR execute from a specific directory
-p PREFIX, --prefix PREFIX
a prefix to apply to all targets
-d, --disable-make whether or not to allow GNU Make target resolution
(default: 'False')
-D DEFAULT, --default DEFAULT
default target to make if none is specified (default:
'all')
-f FILE, --file FILE file to source user-provided recipes from (default:
'Makefile')
-c CONFIG, --config CONFIG
file to source user-provided variable definitions,
ahead of loading package makefiles (default:
'vmklib.json')
-P PROJ, --proj PROJ project name for internal variable use
Note that the full invocation for a target's command is:
mk [options] <prefix>-<command> [ARG1=val1 ARG2=val2]
Targets for use with the datazen package.
Prefix: dz-
DZ_DIR - Optionally override the -C argument.
DZ_MANIFEST - Optionally provide a non-default manifest file to -m.
DZ_VERBOSE - Setting this passes -v as an additional argument.
sync - Run dz, executing the default target.
clean - Run dz with -c to clean the cache.
describe - Run dz with -d to describe cache contents.
install - Install datazen in the resolved virtual environment (with pip). This depends on a "concrete" underlying target that allows it to be installed only once.
upgrade - Upgrade datazen in the resolved virtual environment (with pip).
Targets for rendering GitHub Markdown with grip.
Prefix: grip-
SECRETHUB_GRIP_PATH - The full path for the secrethub read command to source a GitHub personal access token from, requires secrethub.
GRIP_PORT - The host:port String to serve the rendered results on.
GRIP_ENV - Output file to write to for sourcing credentials.
GRIP_FILE - The file to render, path is relative to project root.
check-env - Checks that GRIP_TOKEN is set in the environment, errors if not.
render - Serve README.md with grip.
Targets for uploading packages to PyPI.
Prefix: pypi-
UPLOAD_ENV - Output file to write to for sourcing credentials.
SECRETHUB_PYPI_PATH - The full path for the secrethub read command to source a PyPI API token from, requires secrethub.
check-env - Enforces that TWINE_USERNAME and TWINE_PASSWORD are set in the environment, errors if not.
upload - Attempt to upload everything in dist to PyPI.
Targets for executing common, Python workflow tasks.
Prefix: python-
PY_LINT_ARGS - Set to override the default, adds the tests directory and PY_LINT_EXTRA_ARGS.
PY_WIDTH - Override (from 79) to set --line-length arguments for formatters.
PY_LINT_EXTRA_ARGS - Set to add additional linting arguments.
PYTEST_ARGS - Set to override the default, additional pytest arguments.
PYTEST_EXTRA_ARGS - Add additional arguments to the default set.
PYTHON_COV_PORT - Port to host test-coverage HTML on (using http.server). Defaults to zero.
PY_BUILDER - The target name to use as a python-upload dependency (e.g. python-dist versus python-build). Defaults to python-build.
PY_DOCS_HOST - Host argument passed to pydoc module (-n). Defaults to 0.0.0.0.
PY_DOCS_PORT - Port argument passed to pydoc module (-p). Defaults to 0.
PY_DOCS_EXTRA_ARGS - Extra arguments to pass to the pydoc module.
lint - Run pylint and flake8 against a project's package sources. Also runs the format checkers.
sa - Run mypy against a project's package sources.
sa-types - Run mypy without checking the result and attempt to install missing type/stub packages.
stubs - Run stubgen against a project's package sources.
format - Run black and isort against a project's package sources.
format-check - Run black with the --check argument and isort with the --check-only argument.
tags - Create a tags file for the project using ctags (must be installed).
edit - Create tags and then open $EDITOR in the project directory.
test - Run all of a project's tests with pytest.
test-% - Run project tests based on a search pattern (i.e. the -k option).
view - Attempt to open the test-coverage HTML with $BROWSER (environment variable).
host-coverage - Host test-coverage HTML locally, with the port specified by PYTHON_COV_PORT.
all - Run lint, sa and test in sequence.
clean - Remove compiled and cached files, test coverage, built package artifacts and other caches.
dist - Build sdist and bdist_wheel with setup.py in the project root.
build - Build the package with python -m build.
dist-with-stubs - Build sdist and bdist_wheel with setup.py in the project root, this also runs stubgen ahead of packaging so that stubs are included in the source distribution and wheel.
upload - Use twine to upload the built package to PyPI.
editable - Install the project's package in editable mode (-e option) to the virtual environment.
docs - Run the pydoc module and host HTML documentation via an arbitrary HTTP port.
docs-% - Run the pydoc module and pass the stem as an argument.
deps - Run pydeps against the project (producing SVG output).
Targets for managing Python virtual environments.
Prefix: (no prefix)
PYTHON_VERSION - The version of Python to create a virtual environment for. (default: 3.8)
REQUIREMENTS_DIR - The location of the directory containing requirements files. (default: requirements in the project root)
REQ_FILES - Text files to install requirements from (using -r), in the requirements directory. (default: requirements.txt and dev_requirements.txt)
venv - Create or update the resolved virtual environment, if necessary.
venv-clean - Remove any virtual environments from the project root (or sub-directories).
Targets related to this package, itself.
Prefix: mk-
upgrade - Upgrade (or install) vmklib in the resolved virtual environment.
sys-upgrade - Upgrade (or install) vmklib as a system or user package.
header - Print the Makefile header that should be used when integrating this package.
todo - Perform a case-insensitive search for todo in project directories.
Targets for interacting with yaml data (files).
Prefix: yaml-
YAMLLINT_ARGS - Set to provide arguments to yamllint (such as the path to a config file).
yaml-lint-install - Install yamllint.
yaml-lint-% - Execute yamllint against $*.
A coarse view of the internal structure and scale of
vmklib's source.
Generated using pydeps (via
mk python-deps).
