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.13

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.13
File Size Uploaded Provenance Actions
amps_python_client-5.3.5.13.tar.gz 3.5 MB Without provenance Details for amps_python_client-5.3.5.13.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for amps-python-client 5.3.5.13
File Actions
amps_python_client-5.3.5.13-cp38-abi3-win_amd64.whl CPython 3.8 abi3 Windows x86-64 Details for amps_python_client-5.3.5.13-cp38-abi3-win_amd64.whl
amps_python_client-5.3.5.13-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.13-cp38-abi3-manylinux_2_28_x86_64.whl
amps_python_client-5.3.5.13-cp38-abi3-manylinux_2_28_aarch64.whl CPython 3.8 abi3 Linux glibc 2.28+ ARM64 Details for amps_python_client-5.3.5.13-cp38-abi3-manylinux_2_28_aarch64.whl
amps_python_client-5.3.5.13-cp38-abi3-macosx_14_0_arm64.whl CPython 3.8 abi3 macOS 14.0+ ARM64 Details for amps_python_client-5.3.5.13-cp38-abi3-macosx_14_0_arm64.whl

Total release size: 54.9 MB

Release files / amps_python_client-5.3.5.13.tar.gz

Download URL amps_python_client-5.3.5.13.tar.gz
Size 3.5 MB
Tags Source
SHA-256 checksum
How to use checksums
dd1ad75d36e90ca8991ebca7bb150b161dc5a790ecdf6c4195b2330998dc82bc
BLAKE2b-256 checksum
How to use checksums
62a31abd706599ef04e59dc08ce38cb88db1f6f2e2b1981f287a745ad981a427
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.9

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

Download URL amps_python_client-5.3.5.13-cp38-abi3-win_amd64.whl
Size 462.9 kB
Tags CPython 3.8 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
cf29056073870c7dc727a6b0104994ed44724d42cd15872e4edd492081a99fd9
BLAKE2b-256 checksum
How to use checksums
a1e3e7101210849d91ab394e3069905cbd8be7cd93dbf4df1508f632832772c4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.9

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

Download URL amps_python_client-5.3.5.13-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
48d7feb15baad2275d4569848f1222b9172477068d9e2000d1065e6946e561a6
BLAKE2b-256 checksum
How to use checksums
96babf02d85f5b3c1513ffe585ff9e6f8252dd366958794eb88fce247b7586f4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.9

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

Download URL amps_python_client-5.3.5.13-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
88ecc70e98a51d6500624bf0427d1f6c270aef41077a870f0147c094309899bb
BLAKE2b-256 checksum
How to use checksums
125f37a29012c6030bf4d5960b40ca2d4563a07c7fdcfb5d532114c10b8cf974
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.9

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

Download URL amps_python_client-5.3.5.13-cp38-abi3-macosx_14_0_arm64.whl
Size 917.2 kB
Tags CPython 3.8 abi3 macOS 14.0+ ARM64
SHA-256 checksum
How to use checksums
24eb0d2ec07d3afa3346c36ce1377f5d02fdd41006eb571daf0d451aa41147ca
BLAKE2b-256 checksum
How to use checksums
b2fb06cc079ebae471d3723bd96f64be76d34869c1243cf2c12f0b6223f9a177
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.9

Security for amps-python-client 5.3.5.13

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