Installation/Updates
Using PIP to Install from PyPI
The following instruction are using PIP (Package Installer for Python) as a package manager and PyPI (Python Package Index) as a source of Python packages.
Installing a Wheel Package from PyPI using PIP
Users of pyTooling can select if the want to install a basic variant of pyTooling or an enhanced variant with support
for colored console/terminal outputs (terminal
) and/or support for YAML configuration files (yaml
). In these
cases additional dependencies might be installed. See Dependencies for more details.
# Basic pyTooling package
pip3 install pyTooling
# With setuptools support for pyTooling.Packaging
pip3 install pyTooling[packaging]
# With color support for pyTooling.TerminalUI
pip3 install pyTooling[terminal]
# With YAML support for pyTooling.Configuration.YAML
pip3 install pyTooling[yaml]
# Basic pyTooling package
pip install pyTooling
# With setuptools support for pyTooling.Packaging
pip install pyTooling[packaging]
# With color support for pyTooling.TerminalUI
pip install pyTooling[terminal]
# With YAML support for pyTooling.Configuration.YAML
pip install pyTooling[yaml]
Developers can install further dependencies for documentation generation (doc
) or running unit tests (test
) or
just all (all
) dependencies.
# Install with dependencies to generate documentation pip3 install pyTooling[doc]
# Install with dependencies to run unit tests pip3 install pyTooling[test]
# Install with all developer dependencies pip install pyTooling[all]
# Install with dependencies to generate documentation pip install pyTooling[doc]
# Install with dependencies to run unit tests pip install pyTooling[test]
# Install with all developer dependencies pip install pyTooling[all]
Updating from PyPI using PIP
pip install -U pyTooling
pip3 install -U pyTooling
Uninstallation using PIP
pip uninstall pyTooling
pip3 uninstall pyTooling
Using setup.py
(legacy)
See sections above on how to use PIP.
Installation using setup.py
setup.py install
Local Packaging and Installation via PIP
For development and bug fixing it might be handy to create a local wheel package and also install it locally on the
development machine. The following instructions will create a local wheel package (*.whl
) and then use PIP to
install it. As a user might have a pyTooling installation from PyPI, it’s recommended to uninstall any previous
pyTooling packages. (This step is also needed if installing an updated local wheel file with same version number. PIP
will not detect a new version and thus not overwrite/reinstall the updated package contents.)
Ensure packaging requirements are installed.
cd <pyTooling>
# Package the code in a wheel (*.whl)
python -m build --wheel
# Uninstall the old package
python -m pip uninstall -y pyTooling
# Install from wheel
python -m pip install ./dist/pyTooling-4.1.0-py3-none-any.whl
cd <pyTooling>
# Package the code in a wheel (*.whl)
py -m build --wheel
# Uninstall the old package
py -m pip uninstall -y pyTooling
# Install from wheel
py -m pip install .\dist\pyTooling-4.1.0-py3-none-any.whl