Skip to main content

AMPS Python Client

Introduction

The AMPS Python Client is a Python extension module that makes it easy to connect to AMPS. This client builds upon the AMPS C++ Client and Python/C api to bring high performance AMPS connectivity to Python code.

Prerequisites

To use the AMPS Python Client, you must have the following software installed and configured on your system:

  • Python 3.8 and above.
  • Python setuptools. Most python installations build and include this package by default, but you may run into issues building this extension module if setuptools is not functioning properly on your system.
  • C++ compiler. gcc 4.9 or greater on Linux, or a verion of Visual Studio with Mainstream Support from Microsoft (please refer to Microsoft product lifecycle policies) on Windows. Note that this must be the same compiler used to build your python distribution, else python distutils may be unable to invoke your compiler.

Fedora prerequisites:

  1. dnf install redhat-rpm-config
  2. dnf install python3-devel # for use with Python3
  3. dnf install gcc-c++

Building From a Git Clone

If you obtained this client by a git clone of the 60East amps-client-python repository, you also need to fetch the correct version of the AMPS C++ client submodule. To do this, issue a git submodule command to initialize and update the src/cpp submodule. One easy way to do this is by issuing the command:

git submodule update --init

which will initialize and update the submodule in one step. Note that working with submodules in git requires extra care. Visit this chapter to learn more about git submodules.

Build

This client is distributed as source code and must be compiled before it is used. The build process emits a shared library (or DLL on Windows) that can be imported into your python application.

To build on Linux:

  1. Run python3 setup.py build from the AMPS Python Client directory to build the client.

    This script uses Python distutils to build the client library. Python distutils provides many additional options for installing the built library into your Python distribution, or otherwise controlling the output of the build process. Run python3 setup.py --help to view command help.

  2. Check under the build directory for AMPS.abi3.so -- this is the Python extension module. Ensure this library's directory is in your PYTHONPATH.

  3. To test, run python3 -c "import AMPS". If any errors occur importing the AMPS module, validate that the module built properly, and that the containing directory is in your PYTHONPATH.

To build on Windows:

  1. Use a Visual Studio Command Prompt to create a command prompt where the necessary Visual Studio environment variables are set for command line builds.

  2. Add the Python directory (the location of the python.exe interpreter) to your path.

  3. Run python setup.py build fom the AMPS Python Client directory to build the client module.

  4. Check under the build directory for AMPS.pyd -- this is the Python extension module. Ensure this library's directory is in your PYTHONPATH.

  5. To test, run python -c "import AMPS". If any errors occur importing the AMPS module, validate that the module built properly, and that the containing directory is in your PYTHONPATH.

Installing the Python Binary Wheel

60East also provides Linux-x86-64, Linux-aarch64, Macosx-arm64, and Windows x86-64 64-bit binary wheels built for Python 3.x. These wheel files are provided on the 60East website and are available to install using pip.

Installing From the 60East website:

  1. Download the wheel file from the 60East client release page.

  2. run 'python3 -m pip install *.whl'.

Installing From pip:

  1. run 'python3 -m pip install amps-python-client'.

Troubleshooting Build Problems

Symptom: Python.h not found

Resolution: Update or install python distutils. See the entry on python distutils in the prequisites section for information on installing this package.

For More Information

The AMPS Python Developer's Guide is available on the 60East website. Generated API reference documentation for this client is available under the doc/ directory.

Metadata

Release files for amps-python-client 5.3.5.14

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for amps-python-client 5.3.5.14
File Size Uploaded Provenance Actions
amps_python_client-5.3.5.14.tar.gz 3.5 MB Without provenance Details for amps_python_client-5.3.5.14.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for amps-python-client 5.3.5.14
File Actions
amps_python_client-5.3.5.14-cp38-abi3-win_amd64.whl CPython 3.8 abi3 Windows x86-64 Details for amps_python_client-5.3.5.14-cp38-abi3-win_amd64.whl
amps_python_client-5.3.5.14-cp38-abi3-manylinux_2_28_x86_64.whl CPython 3.8 abi3 Linux glibc 2.28+ x86-64 Details for amps_python_client-5.3.5.14-cp38-abi3-manylinux_2_28_x86_64.whl
amps_python_client-5.3.5.14-cp38-abi3-manylinux_2_28_aarch64.whl CPython 3.8 abi3 Linux glibc 2.28+ ARM64 Details for amps_python_client-5.3.5.14-cp38-abi3-manylinux_2_28_aarch64.whl
amps_python_client-5.3.5.14-cp38-abi3-macosx_14_0_arm64.whl CPython 3.8 abi3 macOS 14.0+ ARM64 Details for amps_python_client-5.3.5.14-cp38-abi3-macosx_14_0_arm64.whl

Total release size: 55.0 MB

Release files / amps_python_client-5.3.5.14.tar.gz

Download URL amps_python_client-5.3.5.14.tar.gz
Size 3.5 MB
Tags Source
SHA-256 checksum
How to use checksums
0f77bb7eabc583e4fb1224e782c8981a539b0edeea291cc653a3f1ba0ff2390c
BLAKE2b-256 checksum
How to use checksums
383e7af9a2235b8630ca4088fa5579405f0d52958b1004bf1a4e599abb228bfd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.13

Release files / amps_python_client-5.3.5.14-cp38-abi3-win_amd64.whl

Download URL amps_python_client-5.3.5.14-cp38-abi3-win_amd64.whl
Size 471.9 kB
Tags CPython 3.8 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
039b0238a0d0e3c9ec9732c56e1771f9b0f521952538014bb69cbdac29afc706
BLAKE2b-256 checksum
How to use checksums
e5da9ad08b8ffbb7d9fe0ee1ae36a5a7a028a87d567fe3c5b26fcdd5f96272e3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.13

Release files / amps_python_client-5.3.5.14-cp38-abi3-manylinux_2_28_x86_64.whl

Download URL amps_python_client-5.3.5.14-cp38-abi3-manylinux_2_28_x86_64.whl
Size 25.2 MB
Tags CPython 3.8 Linux glibc 2.28+ x86-64 abi3
SHA-256 checksum
How to use checksums
36ad7f9af8c7af9d7edb4d5ba05224ff37753da6d6657455423ed4b4ea0760e6
BLAKE2b-256 checksum
How to use checksums
d7c5afd7bee9ded1a91fdc7ee198656875d70f2b560eba18a75cff96cc2bbbfc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.13

Release files / amps_python_client-5.3.5.14-cp38-abi3-manylinux_2_28_aarch64.whl

Download URL amps_python_client-5.3.5.14-cp38-abi3-manylinux_2_28_aarch64.whl
Size 24.9 MB
Tags CPython 3.8 Linux glibc 2.28+ ARM64 abi3
SHA-256 checksum
How to use checksums
1a98499170c3455e749837a9403c04ef0ff14af51e88fc33f5e0fde809a43232
BLAKE2b-256 checksum
How to use checksums
c0341e1bc2f78a459fdfd58b1ccc966973d5f2697012e5c48f7088a7037a0e3c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.13

Release files / amps_python_client-5.3.5.14-cp38-abi3-macosx_14_0_arm64.whl

Download URL amps_python_client-5.3.5.14-cp38-abi3-macosx_14_0_arm64.whl
Size 919.8 kB
Tags CPython 3.8 abi3 macOS 14.0+ ARM64
SHA-256 checksum
How to use checksums
c7909ef6ef623c8d956d680e4bafbd8251ac6e4d98e5cd853f9a372bb8ba991c
BLAKE2b-256 checksum
How to use checksums
d75406120f882b9bb0ef96bc53f408423bd30cd8a2e9b3c10445bc36fb159188
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.13

Security for amps-python-client 5.3.5.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page