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

Linux/macOS

# Basic pyTooling.Sphinx package
pip3 install pyTooling.Sphinx

Windows

# Basic pyTooling.Sphinx package
pip install pyTooling.Sphinx

Developers can install further dependencies for documentation generation (doc) or running unit tests (test) or just all (all) dependencies.

Linux/macOS

With Documentation Dependencies

# Install with dependencies to generate documentation
pip3 install pyTooling.Sphinx[doc]

With Unit Testing Dependencies

# Install with dependencies to run unit tests
pip3 install pyTooling.Sphinx[test]

All Developer Dependencies

# Install with all developer dependencies
pip3 install pyTooling.Sphinx[all]

Windows

With Documentation Dependencies

# Install with dependencies to generate documentation
pip install pyTooling.Sphinx[doc]

With Unit Testing Dependencies

# Install with dependencies to run unit tests
pip install pyTooling.Sphinx[test]

All Developer Dependencies

# Install with all developer dependencies
pip install pyTooling.Sphinx[all]

Updating from PyPI using PIP

Linux/macOS

pip3 install -U pyTooling.Sphinx

Windows

pip install -U pyTooling.Sphinx

Uninstallation using PIP

Linux/macOS

pip3 uninstall pyTooling.Sphinx

Windows

pip uninstall pyTooling.Sphinx

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.Sphinx installation from PyPI, it’s recommended to uninstall any previous pyTooling.Sphinx 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 the packaging requirements build, setuptools and pyTooling are installed.

Linux/macOS

cd <pyTooling.Sphinx>

# Package the code in a wheel (*.whl)
python3 -m build --wheel

# Uninstall the old package
python3 -m pip uninstall -y pyTooling.Sphinx

# Install from wheel
python3 -m pip install ./dist/pytooling_sphinx-0.1.0-py3-none-any.whl

Windows

cd <pyTooling.Sphinx>

# Package the code in a wheel (*.whl)
py -m build --wheel

# Uninstall the old package
py -m pip uninstall -y pyTooling.Sphinx

# Install from wheel
py -m pip install .\dist\pytooling_sphinx-0.1.0-py3-none-any.whl