2.1. Installing XOA Driver
XOA Driver is available to install and upgrade via the Python Package Index. Alternatively, you can also install and upgrade from the source file.
Note
The minimum Xena release supported by XOA Driver is 83.2.
2.1.1. Prerequisites
Before installing XOA Driver, please make sure your environment has installed Python and pip.
Python
XOA Driver requires that you install Python on your system.
Note
XOA Driver requires Python >= 3.8.
pip
Make sure pip is installed on your system. pip is the package installer for Python . You can use it to install packages from the Python Package Index and other indexes.
Usually, pip is automatically installed if you are:
working in a virtual Python environment (virtualenv or venv ). It is not necessary to use
sudo pipinside a virtual Python environment.using Python downloaded from python.org
If you don’t have pip installed, you can:
Download the script, from https://bootstrap.pypa.io/get-pip.py.
Open a terminal/command prompt,
cdto the folder containing theget-pip.pyfile and run:
> py get-pip.py
$ python3 get-pip.py
See also
Read more details about this script in pypa/get-pip.
Read more about installation of pip in pip installation.
2.1.2. Installing From PyPI Using pip
pip is the recommended installer for XOA Driver. The most common usage of pip is to install from the Python Package Index using Requirement Specifiers.
Install to Global Namespace
> pip install tdl-xoa-driver # latest version
> pip install tdl-xoa-driver==1.0.7 # specific version
> pip install tdl-xoa-driver>=1.0.7 # minimum version
$ pip install tdl-xoa-driver # latest version
$ pip install tdl-xoa-driver==1.0.7 # specific version
$ pip install tdl-xoa-driver>=1.0.7 # minimum version
Install in Activated Virtual Environment
Install XOA Driver in a virtual environment, so it does not pollute your global namespace.
For example, your project folder is called /my_xoa_project.
[my_xoa_project]> python -m venv .\env
[my_xoa_project]> .\env\Scripts\activate
(env) [my_xoa_project]> pip install tdl-xoa-driver
[my_xoa_project]$ python3 -m venv ./env
[my_xoa_project]$ source ./env/bin/activate
(env) [my_xoa_project]$ pip install tdl-xoa-driver
See also
Deactivate Virtual Environment
You can deactivate a virtual environment by typing deactivate in your shell.
2.1.3. Upgrading From PyPI Using pip
To upgrade XOA Driver package from PyPI:
2.1.4. Installing Manually From Source
If for some reason you need to install or upgrade XOA Driver manually from source, the steps are:
Step 1, make sure Python packages wheel and setuptools are installed on your system. Install wheel and setuptools using pip:
wheel and setuptools in Windows environment.> pip install wheel setuptools
wheel and setuptools in macOS/Linux environment.$ pip install wheel setuptools
Step 2, download the XOA Driver source distribution from XOA Driver Releases. Unzip the archive and run the setup.py script to install the package:
[xoa_driver]> python setup.py install
[xoa_driver]$ python3 setup.py install
Step 3, if you want to distribute, you can build .whl file for distribution from the source:
2.1.5. Uninstall and Remove Unused Dependencies
pip uninstall tdl-xoa-driver can uninstall the package itself but not its dependencies. Leaving the package’s dependencies in your environment can later create conflicting dependencies problem.
We recommend install and use the pip-autoremove utility to remove a package plus unused dependencies.