dctap 0.4.5

Installation from PyPI

Installing with “pip” pulls the most recently published version of the project from the PyPI repository with the following command:

python3 -m pip install dctap

or uninstalled with:

python3 -m pip uninstall dctap

Installation from Github

“dctap” can be installed directly from Github with:

python3 -m pip install -U https://github.com/dcmi/dctap-python/archive/main.zip

Installing “dctap” this way, and periodically re-running this command to refresh, is the best way to keep up with the latest version of “dctap”.

Installation with pip in virtual environment

For developers who work alot with Python projects, it is good practice to create and activate a virtual environment so that “dctap”, and its dependencies, will not be installed into the global Python environment on your machine. The virtual environment is held in a directory of your choice; in the example below, a hidden directory .venv is created in some_directory (your current working directory), and the virtual environment is activated by executing source .venv/bin/activate.

$ python3 -m venv .venv
$ source .venv/bin/activate
$ python3 -m pip install -U https://github.com/dcmi/dctap-python/archive/main.zip

Note that “dctap” will pip-install even without creating and activating a virtual environment, even though this is not considered good practice. If you do install it into a virtual environment, note that the virtual environment must be activated with source .venv/bin/activate or “dctap” will not work. The activation of a virtual environment can be automated by adding this command to a shell profile where it will be executed when starting the shell, for example by adding the lines to the file “~/.bash_profile”:

cd /Users/foo/somedirectory
source .venv/bin/activate

Installation from a local clone of Git repository

Cloning the “dctap-python” repository to your machine and installing it from the dctap-python directory is a good option if you want to keep up-to-date with the latest developments in the project. The following commands install “dctap” for the first time. In order to refresh the project directly from the project repository, you can at any time execute git pull (from within the repository), which will install the latest features and bug fixes in your local copy.

$ git clone https://github.com/dcmi/dctap-python.git
$ cd dctap-python
$ python -m venv .venv
$ source .venv/bin/activate
$ python3 -m pip install flit Pygments
$ flit install -s