Dependencies

The Python connectors have only one requirement: an existing Python version 3.8, 3.9, 3.10, 3.11, or 3.12 distribution. Other version 3 distributions might need to create a virtual environment to accommodate the version dependency.

Installation

The CData Python Connector for Adobe Commerce setup ZIP contains versions of the connector for Windows, Mac, and Linux.

Python versions 3.8, 3.9, 3.10, 3.11, and 3.12 are supported.

For Windows environments, use the whl file of the appropriate Python version and bitness with the "pip install" command. For example, once your command prompt is in the pertinent directory, the following command is appropriate for a 64-bit Python 3.9 distribution on a Windows environment, after the version number has been adjusted accordingly:

pip install cdata_adobecommerce_connector-23.0.8572-cp39-cp39-win_amd64.whl

For Linux or Mac environments, the package is a tar.gz file instead. Once again, the "pip install" command is used via the terminal. For example, the following command is appropriate to install the connector for a Python 3 distribution in a Linux environment, after the version number has been adjusted accordingly:

pip install cdata-adobecommerce-connector-23.0.xxxx-python3.tar.gz

Regardless of the environment, certain distributions might require that the "pip3 install" command be used instead, to differentiate from a Python 2 distribution that might exist already. After installation, confirm whether the connector is successfully installed by running the "pip list" command. If "cdata-adobecommerce-connector" is present in the list output by the command, then the installation was successful.

Licensing

After the installation is complete, a separate step is needed to activate a license for the connector. Among the CData assets in the distribution's site packages, there is an install-license tool that activates this license. From within the distribution's site-packages folder, after navigating to the "cdata/installlic_adobecommerce" folder, simply use a command like the below to activate the license. Omitting the <key> argument activates a trial license:

• Windows:
  

  ./install-license.exe <key>

• Linux / Mac:
  

  ./install-license.sh <key>

Sometimes, file access issues may cause pip to install the connector in a fallback file path that is not the python distribution's main or primary site-packages location. This can make it difficult to find where the connector was installed, and from there, the license activator. In that event, this python script below will print out the full file path of the connector's native file. This file will be stored in the mentioned cdata folder, from which the installlic_adobecommerce folder is trivial to find:

import os
import cdata.adobecommerce
path = os.path.abspath(cdata.adobecommerce.__file__)
print(path)

Uninstallation

If the connector needs to be uninstalled for any reason, do so by running the pip uninstall command, as in the example below:

pip uninstall cdata-adobecommerce-connector