This document covers how to setup a Python environment to work on Agent-based Integrations, including installing the interpreter and ensuring all of the required dependencies are present.
Integrations run either within the Agent’s embedded Python environment or within the testing environment. The current version of the embedded environment is recorded in the Omnibus code. The Agent and testing environments are Python 2, but an eventual upgrade to Python 3 is inevitable, thus new Integrations must be compatible with both versions.
Many operating systems come with Python pre-installed. If your system Python is too old, or if it is not pre-installed, you must install an appropriate version. The installation and maintenance of Python in every operating system is outside the scope of this document, however, some pointers are provided for your benefit.
Any recent version of macOS comes with Python pre-installed, however, it may be older than the version used in the Agent, and might also lack required tools and dependencies. You must install a fresh, dedicated Python interpreter that you can manage without the App Store.
It is recommended to install an environment manager in order to preserve a clean system Python.
All mainstream distributions of Linux come with Python pre-installed — likely one of an acceptable version level. It is recommended to install an environment manager in order to preserve a clean system Python. Refer to your distribution’s package management documentation for more information.
Windows does not normally have a Python environment present. The official Python documentation contains detailed installation instructions and links to further documentation and tooling.
Each integration has its own set of dependencies that must be added to Python in order to run the tests, or just to try out the collection code. To avoid polluting your Python installation with libraries and packages that would only be used by an Integration, use a “virtual environment”. A virtual environment is a self contained directory tree that contains an isolated Python installation. When a virtual environment is active, any package you install goes into that directory without affecting the system wide Python installation.
We recommend using Virtualenv to manage Python virtual environments, and virtualenvwrapper to make the process smoother. There’s a comprehensive guide in the Hitchhiker’s Guide to Python describing how to set up these two tools.
If you’re using Miniconda, a tool to manage virtual environments is included. Refer to the official guide for more information.