Skip to content

CLI Reference

The full command line, generated from wj-publish --help:

usage: wj-publish [-h] [--version] [--example-config] [-c FILE] [-p NAME]
                  [--pypi-only | --docs-only] [-f] [-v]
                  [DIR]

wj-publish: 1.0.0b4
(c) 2026 WaterJuice. Unlicense.

Publish WaterJuice projects: wheels to PyPI and documentation to the git
repository that Cloudflare Pages serves. By default both are published,
based on what the selected profile configures. Use --pypi-only / --docs-only
to limit.

positional arguments:
  DIR                 Build directory containing the .whl files and the docs
                      .zip (e.g. output/)

options:
  -h, --help          show this help message and exit
  --version           show program's version number and exit
  --example-config    print an example config file and exit
  --pypi-only         only publish wheels to PyPI
  --docs-only         only publish documentation
  -f, --force         overwrite an existing docs version
  -v, --verbose       verbose output

Configuration:
  -c, --config FILE   config file (default: $WJ_PUBLISH_CONFIG or
                      ~/.config/wj-publish/config.json)
  -p, --profile NAME  profile to use (default: $WJ_PUBLISH_PROFILE or
                      [tool.wj-publish] in pyproject.toml)