# Note: Install Python 3

# Note: install Poetry for Linux
$: curl -sSL https://raw.githubusercontent.com/python-poetry/poetry/master/get-poetry.py | python

# Note: install Poetry for Windows
$: (Invoke-WebRequest -Uri https://raw.githubusercontent.com/python-poetry/poetry/master/get-poetry.py -UseBasicParsing).Content | python
# Note: do NOT update Poetry, it will break itself

$: python get-poetry.py --uninstall

# Note: `.toml` project name and package have no match (wiki-tools; wiki_tools)
$: poetry install  # install all dependencies

$: pip install dist/wiki_tools-0.0.1-py3-none.any.whl

$: wiki-tools

$: poetry shell
$: cd docs
# Note: review source/conf.py and source/index.rst
$: make html
# Note: see docs in docs/build/apidocs/index.html

$: poetry run python ./wiki_tools/runner.py

$: poetry run pytest --durations=0

$: poetry run pytest --cov=wiki_tools --cov-report=html tests
#: Note: see coverage report in htmlcov/index.html

$: poetry search Package-Name
$: poetry add [-D] Package-Name[==Package-Version]

$: poetry run black .

$: poetry config pypi-token.pypi PyPI-API-Access-Token

$: poetry publish --build

https://pypi.org/project/wiki-tools/