Skip to main content

Python Client library for the Aleph.im network

Project description

aleph-client

Python Client for the aleph.im network, next generation network of decentralized big data applications. Development follows the Aleph Whitepaper.

Documentation

Documentation can be found on https://docs.aleph.im/tools/aleph-client/

Requirements

Linux

Some cryptographic functionalities use curve secp256k1 and require installing libsecp256k1.

apt-get install -y python3-pip libsecp256k1-dev

macOs

brew tap cuber/homebrew-libsecp256k1 brew install libsecp256k1

Windows

The software is not tested on Windows, but should work using the Windows Subsystem for Linux (WSL).

Installation

From PyPI

Using pip and PyPI:

pip install aleph-client

Using a container

Use the Aleph client and it's CLI from within Docker or Podman with:

docker run --rm -ti -v $(pwd)/data:/data ghcr.io/aleph-im/aleph-client/aleph-client:master --help

Warning: This will use an ephemeral key pair that will be discarded when stopping the container

Installation for development

We recommend using hatch for development.

Hatch is a modern, extensible Python project manager. It creates a virtual environment for each project and manages dependencies.

pip install hatch

Running tests

hatch test

or

hatch run testing:cov

Formatting code

hatch run linting:format

Checking types

hatch run linting:typing

Publish to PyPI

hatch build hatch upload

If you want NULS2 support you will need to install nuls2-python (currently only available on github):

pip install aleph-sdk-python[nuls2]

To install from source and still be able to modify the source code:

pip install -e .

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

aleph_client-1.2.0.tar.gz (41.0 kB view details)

Uploaded Source

Built Distribution

aleph_client-1.2.0-py3-none-any.whl (51.7 kB view details)

Uploaded Python 3

File details

Details for the file aleph_client-1.2.0.tar.gz.

File metadata

  • Download URL: aleph_client-1.2.0.tar.gz
  • Upload date:
  • Size: 41.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.10.12

File hashes

Hashes for aleph_client-1.2.0.tar.gz
Algorithm Hash digest
SHA256 fffee07194ae585f0ec2472b7c02c8ef1baa4fe2f3a95c0f7a415c150c1b4961
MD5 ea81a03fa278d7e98b6a0e45207a88c6
BLAKE2b-256 b9baa81f3c976a4c6e6507bf97c42f2b0b60eb666e14be8260f673dc72fa96e4

See more details on using hashes here.

Provenance

File details

Details for the file aleph_client-1.2.0-py3-none-any.whl.

File metadata

  • Download URL: aleph_client-1.2.0-py3-none-any.whl
  • Upload date:
  • Size: 51.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.10.12

File hashes

Hashes for aleph_client-1.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 47c22373b45ee8c4da79639c7b8947430a45e3b50068c24d4593bce9818b2617
MD5 4b480f539b9eab2094a49dc403b3e723
BLAKE2b-256 40003f87cfab7920581cc864442f631893c15812d559b2e3b5b5cb7da8eb62a6

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page