Provides TCP functionality for Ingots projects
Project description
Ingot Tcp Ingot package.
Provides TCP functionality for Ingots projects
For consumers
For using the Ingot package just execute the following command:
pip install ingot_tcp
Of course, need to activate a destination virtual environment:
source .venv/bin/activate
... or to create it, if it hasn't prepared yet:
python3 -m venv .venv
Bootstrap
The Ingot package provides the Bootstrap CLI tool.
It allows to get started with the Ingot package quickly.
It generates the following skeletons:
TODO. Add builders here after generating theirs by the ingots package_bootstrap
tool.
For using the CLI tool just call the following command:
ingot-tcp <command> --name=<entity_name> --description="The <entity> brief description."
Getting help:
ingot-tcp --help
ingot-tcp <command> --help
For developers
Prepare the project for working
Clone a repository:
mkdir ingots-libs
cd ingots-libs
git clone https://github.com/<path>/ingot_tcp.git
cd ingot_tcp
Prepare a virtual environment:
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
Prepare repository hooks
pip install pre_commit
pre-commit install
Configure code-quality tools:
pip install black flake8 mypy coverage
Configure the Sphinx tool
Please, use the following page for configuring the Sphinx documentation generator: Sphinx
pip install sphinx
sphinx-build -b html docs docs/build -v
Using the tox tool
The Ingot package allows automation via the tox
tool.
pip install tox
Use configured tox tool for several activities.
tox -e reformat
- auto reformat code by the black tool, makes ordering import too.
tox -e cs
- checks code style by PEP8.
tox -e ann
- checks annotations of types by the mypy tool.
tox -e utc
- runs unittests with the coverage tool.
tox -e report
- builds coverage report for the project.
tox -e doc
- builds a package documentation.
tox -e build
- builds a package form current branch / tag / commit. Set the {NAME}_VERSION_SUFFIX
virtual variable for specify package suffix.
tox -e upload
- uploads package to the PyPI index. Set the PYPI_REPOSITORY_ALIAS
virtual variable for specify PyPI destination.
Calling tox without parameters will execute the following steps: cs, ann, utc and report.
Using package bootstrap locally
Obviously, it's impossible to call the package bootstrap tool via package entry-point.
Use the following command instead:
python -m ingot_tcp.scripts.ingot_tcp ...
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for ingot_tcp-0.1.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a8a1bf8846826f96091ddf5620301f88c2de44b5c79b4fb80e0ec039de79dd89 |
|
MD5 | 0f3d756065b5d8468be51033afd25657 |
|
BLAKE2b-256 | 6037cc6b81aa77585a752497625f1595a95e04030bcc495222e18f376d205d0c |