Autogenerate USAGE.md for click cli projects
Go to file
Jules d3582d872e Bumping version from 0.6.2 to 0.7.0 2022-08-11 11:56:53 +02:00
clickusagelib Simplify clickusagemd pre-push hook detection. 2022-07-20 09:50:30 +02:00
.gitignore Add .gitignore 2022-07-18 22:48:35 +02:00
.pre-commit-config.yaml Initial commit. 2022-07-15 11:23:45 +02:00
README.md Updated README.md 2022-07-20 10:12:56 +02:00
USAGE.md Updated README.md 2022-07-20 10:12:56 +02:00
clickusagemd.py clickusagemd searches for git root to locate pyproject.yaml 2022-08-11 11:56:06 +02:00
poetry.lock clickusagemd searches for git root to locate pyproject.yaml 2022-08-11 11:56:06 +02:00
pyproject.toml Bumping version from 0.6.2 to 0.7.0 2022-08-11 11:56:53 +02:00

README.md

Click Usage Markdown Generator

Installation

Add clickusagemd as development dependency to your Poetry project.

poetry add -D git+ssh://git@git.goatpr0n.de/Tools/clickusagemd.git

By adding a revision tag you can stay on a — at least for you — working version, instead of working with the latest and possible broken commit.

The latest recommended revision is: 0.6.2.

To install:

poetry add -D git+ssh://git@git.goatpr0n.de/Tools/clickusagemd.git@0.6.2

After installing, register the pre-push hook. The hook is installed by executing the command poetry run clickusagemd install. If an previous, untagged version of the pre-push hook was installed you might need to manually delete the file .git/hooks/pre-push before installing. Later versions of clickusagemd will detect its own pre-hook files and will install or update them.

Updating

To update clickusagemd either run

poetry update clickusagemd

with , or to update all Poetry dependencies at once

poetry update

Usage

See USAGE.md.

Uninstall

Clickusagemd can be uninstalled by removing the pre-push hook with

poetry run clickusagemd uninstall

or by manually deleting the file .git/hooks/pre-push.

To completely remove the clickusagemd command use the Poetry package manager to remove the dependency.

poetry remove -D clickusagemd