Python Version¶

Webware for Python 3.1 requires at least Python version 3.10.

Create a Virtual Environment¶

Though you can install Webware for Python 3 into your global Python environment, we recommend creating a separate virtual environment for every Webware for Python 3 project.

To create such a virtual environment in the .venv subdirectory of the current directory, run the following command:

python3 -m venv .venv

If you are using Windows, may may need to run the following instead:

py -3 -m venv .venv

Activate the Virtual Environment¶

To activate the virtual environment, you need to execute the “activate” command of the virtual environment like this:

. .venv/bin/activate

Or, if your are using Windows, the “activate” command can be executed like this:

.venv\Scripts\activate

Installation with Pip¶

With the virtual environment activated, you can now download and install Webware for Python 3 in one step using the following command:

pip install "Webware-for-Python>=3"

For developing with Webware for Python, you will probably also install “extras” as explained below.

Installing “Extras”¶

When installing Webware for Python 3, the following “extras” can optionally be installed as well:

• “dev”: extras for developing Webware applications

• “examples”: extras for running all Webware examples

• “tests”: extras needed to test all functions of Webware

• “docs”: extras needed to build this documentation

On your development machine, we recommend installing the full “tests” environment which also includes the other two environments. To do that, you need to specify the “Extras” name in square brackets when installing Webware for Python 3:

pip install "Webware-for-Python[tests]>=3"

Installation from Source¶

Alternatively, you can also download Webware for Python 3 from PyPI, and run:

python -m pip install .

Or, to create an editable installation with the extras for testing:

python -m pip install -e .[tests]

Check the Installed Version¶

In order to check that Webware has been installed properly, run the command line tool webware with the --version option:

webware --version

This should show the version of Webware for Python 3 that you have installed. Keep in mind that the virtual environment into which you installed Webware for Python 3 needs to be activated before you run the “webware” command.