Aerospike Client Library for Python
Project description
Dependencies
The Python client for Aerospike works with Python 3.5, 3.6, 3.7, 3.8 running on 64-bit OS X 10.9+ and Linux.
NOTE: Python client 5.0.0 and up MUST be used with Aerospike server 4.9 or later. If you see the error “-10, ‘Failed to connect’”, please make sure you are using server 4.9 or later.
NOTE: The following dependencies only apply to installations that build from source on linux, or OS X installations. For client>=3.8.0 and pip>=19.0 on linux platforms, can skip to “Install” section.
The client depends on:
Python devel package
OpenSSL
The Aerospike C client
RedHat 6+ and CentOS 6+
The following are dependencies for:
RedHat Enterprise (RHEL) 6 or newer
CentOS 6 or newer
Related distributions which use the yum package manager
sudo yum install python-devel sudo yum install openssl-devel
Debian 6+ and Ubuntu 14.04+
The following are dependencies for:
Debian 6 or newer
Ubuntu 14.04 or newer
Related distributions which use the apt package manager
sudo apt-get install python-dev sudo apt-get install libssl-dev
You may also need libz:
sudo apt-get install zlib1g-dev
OS X
By default OS X will be missing command line tools. On Mavericks (OS X 10.9) and higher those can be installed without Xcode.
xcode-select --install # install the command line tools, if missing
OpenSSL can be installed through the Homebrew OS X package manager.
brew install openssl
Install
Aerospike Python Client can be installed using pip:
pip install aerospike # client >=3.8.0 will attempt a manylinux2010 wheel installation for linux distros # to force a pip install from source: pip install aerospike --no-binary :all: # to troubleshoot pip versions >= 6.0 you can pip install --no-cache-dir aerospike # to trouleshoot installation on OS X El-Capitan (10.11) or OS X Sierra (10.12) pip install --no-cache-dir --user aerospike
If you run into trouble installing the client on a supported OS, you may be using an outdated pip. Versions of pip older than 7.0.0 should be upgraded, as well as versions of setuptools older than 18.0.0.
OS X Installation
Upgrading pip on OS X El-Capitan (10.11) or OS X Sierra(10.12) runs into SIP issues with pip install --user aerospike as the recommended workaround to install aerospike on those versions of OS X.
Attempting to install the client with pip for the system default Python may cause permissions issues when copying necessary files. In order to avoid those issues the client can be installed for the current user only with the command: pip install --user aerospike
If the version of Python is not in the officially supported list, or the --install-option argument is provided, pip will attempt to compile the client from source. Please see the build directions in the GitHub repository to troubleshoot any issues caused by compiling the client.
Build
For instructions on manually building the Python client, please refer to the BUILD.md file in this repo.
Documentation
Documentation is hosted at aerospike-python-client.readthedocs.io and at aerospike.com/apidocs/python.
Examples
Example applications are provided in the examples directory of the GitHub repository
For examples, to run the kvs.py:
python examples/client/kvs.py
Benchmarks
To run the benchmarks the python module ‘tabulate’ need to be installed. In order to display heap information the module guppy must be installed. Note that guppy is only available for Python2. If guppy is not installed the benchmarks will still be runnable. Benchmark applications are provided in the benchmarks directory of the GitHub repository
By default the benchmarks will try to connect to a server located at 127.0.0.1:3000 , instructions on changing that setting and other command line flags may be displayed by appending the –help argument to the benchmark script. For example:
python benchmarks/keygen.py --help
License
The Aerospike Python Client is made availabled under the terms of the Apache License, Version 2, as stated in the file LICENSE.
Individual files may be made available under their own specific license, all compatible with Apache License, Version 2. Please see individual files for details.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
Hashes for aerospike-5.0.0-cp38-cp38-manylinux2010_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a77c8af0cad03bcf047e0a787870b87bcddb87419da071bf99eb8c10ad7be271 |
|
MD5 | ffcd8579d2ace4f6a0beac3f4ac40b3a |
|
BLAKE2b-256 | 1dcf725f0e8088281a942085778a6b0ba590cbc64cc638c996462a962a4334d7 |
Hashes for aerospike-5.0.0-cp38-cp38-macosx_10_6_intel.macosx_10_9_intel.macosx_10_9_x86_64.macosx_10_10_intel.macosx_10_10_x86_64.macosx_10_11_intel.macosx_10_11_x86_64.macosx_10_12_intel.macosx_10_12_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | e7fe90a34b16e0d2f2f02a10678d15f08013bda05d152a6a7dae99fe413819dc |
|
MD5 | cd6ba64fee341c969578ae984e1761bb |
|
BLAKE2b-256 | b0715a9c160b52c971ffa0db5a938e51f73c19b59ef1b0ec883fc6ab38b6605d |
Hashes for aerospike-5.0.0-cp37-cp37m-manylinux2010_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 36a9364fce01a877c409d2da2680bde85f71e4745e813af33e30b670a6a45c69 |
|
MD5 | 4ac09de3da2d9701ab475e75cc151144 |
|
BLAKE2b-256 | 3d538d5889916474dfee849108e1777711da4a8438251f47ff2e6570ed420a01 |
Hashes for aerospike-5.0.0-cp37-cp37m-macosx_10_6_intel.macosx_10_9_intel.macosx_10_9_x86_64.macosx_10_10_intel.macosx_10_10_x86_64.macosx_10_11_intel.macosx_10_11_x86_64.macosx_10_12_intel.macosx_10_12_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | e4b64a0e22ade9377eea011516351df04aaea41d63c9fa269f3652b10817b3c3 |
|
MD5 | 554e853df0371d85947df5d2102e2a90 |
|
BLAKE2b-256 | c95b6ffc84de43d9f025d98ebbc6c5d6dfe4632cdfe8f4e49b2087567f62df28 |
Hashes for aerospike-5.0.0-cp36-cp36m-manylinux2010_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7bbbc718da6359a491ac3bf6a96e3c83f665c9fecb81cce3a604a11896be9eca |
|
MD5 | 1778e156bbbc1586d36476469b73b7b4 |
|
BLAKE2b-256 | 57628c267a24929d24e3e4493fadadc2e9272dda25a11d330b52509a38e10ca0 |
Hashes for aerospike-5.0.0-cp36-cp36m-macosx_10_6_intel.macosx_10_9_intel.macosx_10_9_x86_64.macosx_10_10_intel.macosx_10_10_x86_64.macosx_10_11_intel.macosx_10_11_x86_64.macosx_10_12_intel.macosx_10_12_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 251b60a3d1e6a16b53e53f5b9a8a9a07175e8d3095eb0c00e3aebdee72511cf2 |
|
MD5 | d06d5986e63520da56a7bf7e76236000 |
|
BLAKE2b-256 | 723b15a579cff48331d785517f14ecceb1516a5cef9c9271818d45d0531c9d7c |
Hashes for aerospike-5.0.0-cp35-cp35m-manylinux2010_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 755358e5bf831f0521058f4397844590f7bc4ae7cb0bd0cd93c25c83b315a953 |
|
MD5 | a67b431413c4c359ae8f36e4d1838e55 |
|
BLAKE2b-256 | 7bd5cd749fc780e6a30416348a45584fca5e6b81734c55c8edc3bb1184fadff6 |
Hashes for aerospike-5.0.0-cp35-cp35m-macosx_10_6_intel.macosx_10_9_intel.macosx_10_9_x86_64.macosx_10_10_intel.macosx_10_10_x86_64.macosx_10_11_intel.macosx_10_11_x86_64.macosx_10_12_intel.macosx_10_12_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | e256c590f3af6f8ee836a9e7a7e55d893c38a555ed656cfd4713463f8bacac98 |
|
MD5 | a155ce489185d1d34f38f67a6c0a45fe |
|
BLAKE2b-256 | b4a45b0baaaf0e491cb1303d483e79ad937f7806861793934b32dd0c7f3fcb68 |