This section describes how to install the PDS Deep Archive.
Prior to installing this software, ensure your system meets the following requirements:
Python 3. This software requires Python 3.9. Python 2 will absolutely not work, and indeed Python 2 came to its end of life on the first of January, 2020. Run
python --version, or
python3 --version, to check it is installed.
libxml2version 2.9.2; later 2.9 versions are fine. Run
xml2-config --versionto find out.
libxsltversion 1.1.28; later 1.1 versions are OK too. Run
It is highly recommended you install using Python Anaconda as it comes pre-packaged with the necessary dependencies to run the application.
During installation, be sure to check the box to add the Anaconda distribution to PATH.
Consult your operating system instructions or system administrator to install the required packages. For those without system administrator access and are feeling anxious, you could try a local (home directory) Python 3 installation using a Miniconda installation.
Doing the Installation¶
Some things to be aware of regarding examples below:
The octothorp characters
#below indicate comments and need not be typed in.
The location of where you choose to create a Python virtual environment is entirely your preference.
The examples below should be seen only as suggestions. Invoking command lines below are demonstrative.
Please consult your system documentation for the appropriate invocations for your operating system, command shell (or “terminal”), and so forth.
The easiest way to install this software is to use Pip, the Python Package
Installer. If you have Python on your system, you probably already have Pip;
you can run
pip3 --help to check.
It’s best install the PDS Deep Archive into a virtual environment so it won’t interfere with—or be interfered by—other packages. To do so:
# For Linux / Mac / other Unix systems # Example assumes bash command shell. For others, consult shell documentation. mkdir -p $HOME/.virtualenvs python3 -m venv $HOME/.virtualenvs/pds-deep-archive source $HOME/.virtualenvs/pds-deep-archive/bin/activate pip3 install pds.deeparchive # For Windows mkdir virtualenvs python -m venv virtualenvs\\pds-deep-archive virtualenvs\\pds-deep-archive\\Scripts\\activate pip3 install pds.deeparchive
It’s also possible to use
easy_install if you prefer, or to install it
via a Buildout, or (if you must) into the system Python.
You can then run
pds-deep-archive --help or
pds-deep-registry-archive --help to get a usage message and ensure
it’s properly installed.
The above commands will install last approved release from the Python Package Index (“Cheeseshop”). The latest, cutting edge release is posted at the Test Package Index, but these releases may not be fully confirmed to be operational. If you like taking risks, run the following to create a new virtual environment and install the latest development version of the software:
mkdir -p $HOME/.virtualenvs python3 -m venv $HOME/.virtualenvs/pds-deep-archive source $HOME/.virtualenvs/pds-deep-archive/bin/activate pip3 install --index-url https://test.pypi.org/simple --extra-index-url https://pypi.org/simple`` pds.deeparchive
To check and install an upgrade to the software, run the following command in your virtual environment:
source $HOME/.virtualenvs/pds-deep-archive/bin/activate pip install pds.deeparchive --upgrade
The same admonitions mentioned earlier about command line invocations also apply to the above example.
Activating a virtual environment is deprecated (as per the Python philosophy of “explicit is better than implicit”); the
bin/activate commands are left above for now for specific reasons.