rapdevpy 0.3.0

A (personal) rapid development Python library that manages common tasks, tests and knowledge.

Rapid Development Library for Python

• lxml: parsing XML and HTML
• networkx: graph, edge and vertex analysis

Install and use

# Note: Install Python 3
# Update pip and install virtualenv (dependency encapsulator) and black (linter; IDE needs to be restarted)

# 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 to match (rapdevpy; rapdevpy)
$: poetry install  # install all dependencies

dist

$: pip install dist/rapdevpy-0.1.3-py3-none.any.whl

$: rapdevpy

docs

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

rapdevpy

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

tests

$: poetry run pytest --durations=0

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

poetry.lock

Dependencies, Python version and the virtual environment are managed by Poetry.

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

pyproject.toml

Define project entry point and metadata.

setup.cfg

Configure Python libraries.

Linters

$: poetry run black .

cProfile

$: poetry run python ./rapdevpy/profiler.py

Build and publish

$: poetry build

# Note: get the token from your PiPy account
$: poetry config pypi-token.pypi PyPI-Api-Access-Token

$: poetry publish --build

https://pypi.org/project/rapdevpy/