Install with pip

Follow the steps below to install the retaining wall package directly with pip from the Azure Artifacts feed.

Prefer managing the project with Poetry instead? See Install with Poetry.

Prerequisites

• Python 3.12+
• pip
• Access to the Azure DevOps package feed
• A virtual environment created and activated

1. Install Azure Artifacts Authentication

Install artifacts-keyring first. This helps pip authenticate against the Azure Artifacts feed.

python -m pip install artifacts-keyring

2. Install the Package

Use the Azure Artifacts feed as the primary package source, while keeping the public PyPI repository available as a fallback.

pip install --index-url https://pkgs.dev.azure.com/corporateroot/_packaging/haskoning-py/pypi/simple/ --extra-index-url https://pypi.org/simple haskoning-retaining-wall

3. Verify the package was installed

Confirm that haskoning-retaining-wall is present in your active virtual environment:

pip show haskoning-retaining-wall

This should print the package's metadata (name, version, location, …). If instead you see a WARNING: Package(s) not found message, the install did not complete successfully — check the output of the pip install command above for errors and re-run it.

You can also confirm the retaining-wall command-line tool is available:

retaining-wall --help

Notes

• If you are working inside a virtual environment, make sure it is activated (see Create a Virtual Environment) before running the commands above.
• If installation fails with an authentication error, make sure you have access to the Azure DevOps feed and that artifacts-keyring is installed in the same Python environment you are using for pip.
• Remember to reactivate the virtual environment each time you open a new terminal session to work on this project.