Supported Environments for the Solace Python API

The Solace Python API is compatible and supported with any version of Python that is in active support and also has security update support. For information about the supported versions of Python, see the Python.org website.

The Solace Python API is compatible with the following systems:

  • Windows (32-bit and 64-bit versions) that are in active support and also have security update support.
  • Linux (x86/x86_64) variants that are in active support and also have security update support, running either:
    • glibc version 2.17 or later (desktop/server only), which includes Debian-based (e.g., Ubuntu) and CentOS/RHEL-based (e.g., Red Hat Linux, CentOS) distributions.
    • musl-c version 1.2 or later (Alpine Linux).
  • Linux (ARM) variants that are in active support and also have security update support, running:
    • glibc version 2.17 or later (desktop/server only), which includes Debian-based (e.g., Ubuntu) and CentOS/RHEL-based (e.g., Red Hat Linux, CentOS) distributions.
  • macOS [x86_64 versions and ARM (M-Series processors)] that are in active support and also have security update support.

Installing the Solace Python API

You can retrieve Solace Python API from solace-pubsubplus. Alternatively, you can install the Solace Python API with pip by using the following command in your project directory:

pip install solace-pubsubplus

The command above retrieves and installs the latest version of the Solace Messaging API for Python.

OpenSSL Compatibility

The Solace Python API is compatible with OpenSSL 3.0 and OpenSSL 1.1. The Solace Python API bundles OpenSSL libraries for developer convenience only; these libraries are unsuitable for production environments. OpenSSL binaries are bundled with the following:

  • for macOS and Windows, all versions of the Solace Python API
  • for Linux, versions 1.7 and earlier of the Solace Python API

OpenSSL is required for encrypted (TLS) connections to Solace event brokers. For production environments, we recommend you install OpenSSL directly to ensure that you have the most recent version. To install OpenSSL:

  • Use your preferred package manager for Python.
  • Download, build, and install OpenSSL from www.openssl.org.

TLS and SSL Support

Transport Layer Security (TLS) provides secure connections between the Solace Python API and event brokers. The Solace Python API supports the following TLS versions. The recommended version to use is the most recent version of TLS:

  • TLS 1.2
  • TLS 1.3—Requires Solace Python API, version 1.10 or later .

In this documentation, the term TLS/SSL refers to Transport Layer Security (TLS) and Secure Sockets Layer (SSL) protocols used for securing data transmission. We don't recommend that you use SSL unless it's required for backwards compatibility.

Using an Integrated Development Environment

If you are using an Integrated Development Environment (IDE), such as PyCharm, integrated help is available, provided you have Docstrings rendered as reStructuredText. In some IDEs, you configure this in the settings. For example, in PyCharm, you go to File > Settings >Tool > Python Integrated Tools, select reStructureText in the Docstring format list, and click Apply.

Screenshot showing an example as described by the surrounding text.