# Aptos Python SDK
[![Discord][discord-image]][discord-url]
[![PyPI Package Version][pypi-image-version]][pypi-url]
[![PyPI Package Downloads][pypi-image-downloads]][pypi-url]
This provides basic functionalities to interact with [Aptos](https:/github.com/aptos-labs/aptos-core/). Get started [here](https://aptos.dev/guides/system-integrators-guide/#getting-started).
Currently this is still in development and may not be suitable for production purposes.
Note: The sync client is deprecated, please only start new projects using the async client. Feature contributions to the sync client will be rejected.
## Requirements
This SDK uses [Poetry](https://python-poetry.org/docs/#installation) for packaging and dependency management:
```
curl -sSL https://install.python-poetry.org | python3 -
poetry install
```
## Unit testing
```bash
make test
```
## E2E testing
First, run a local testnet (run this from the root of aptos-core):
```bash
cargo run -p aptos -- node run-local-testnet --with-faucet --faucet-port 8081 --force-restart --assume-yes
```
Next, tell the end-to-end tests to talk to this locally running testnet:
```bash
export APTOS_NODE_URL="http://127.0.0.1:8080/v1"
export APTOS_FAUCET_URL="http://127.0.0.1:8081"
```
Finally run the tests:
```bash
make examples
```
Note: These end-to-end tests are tested against a node built from the same commit as part of CI, not devnet. For examples tested against devnet, see `developer-docs-site/static/examples/python/` from the root of the repo.
## Autoformatting
```bash
make fmt
```
## Generating types
The Python `openapi-python-client` tool cannot parse references. Therefore there are three options:
- Use swagger-cli to dereference, gain a type explosion, and still have missing types
- Live without missing types
- Write a pure python implementation with no autogenerated code
Currently the team is moving forward with pure python, but leaves the following notes for the curious:
```bash
npm install -g @apidevtools/swagger-cli
swagger-cli bundle --dereference ../../../api/doc/v0/openapi.yaml -t yaml > openapi.yaml
python3 -m openapi_python_client generate --path openapi.yaml
mv aptos-dev-api-specification-client/aptos_dev_api_specification_client/ aptos_sdk/openapi
```
## Semantic versioning
This project follows [semver](https://semver.org/) as closely as possible
[repo]: https://github.com/aptos-labs/aptos-core
[pypi-image-version]: https://img.shields.io/pypi/v/aptos-sdk.svg
[pypi-image-downloads]: https://img.shields.io/pypi/dm/aptos-sdk.svg
[pypi-url]: https://pypi.org/project/aptos-sdk
[discord-image]: https://img.shields.io/discord/945856774056083548?label=Discord&logo=discord&style=flat~~~~
[discord-url]: https://discord.gg/aptosnetwork
Raw data
{
"_id": null,
"home_page": "https://github.com/aptos-labs/aptos-core/tree/main/ecosystem/python/sdk",
"name": "aptos-sdk-zzf",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8.1,<4.0",
"maintainer_email": "",
"keywords": "web3,sdk,aptos,blockchain",
"author": "Aptos Labs",
"author_email": "opensource@aptoslabs.com",
"download_url": "https://files.pythonhosted.org/packages/32/2b/114d6ce3056f1f587efbf0f39fc32d00ac6a43bd7255119186de89828c11/aptos_sdk_zzf-0.7.0.tar.gz",
"platform": null,
"description": "# Aptos Python SDK\n[![Discord][discord-image]][discord-url]\n[![PyPI Package Version][pypi-image-version]][pypi-url]\n[![PyPI Package Downloads][pypi-image-downloads]][pypi-url]\n\nThis provides basic functionalities to interact with [Aptos](https:/github.com/aptos-labs/aptos-core/). Get started [here](https://aptos.dev/guides/system-integrators-guide/#getting-started).\n\nCurrently this is still in development and may not be suitable for production purposes.\n\nNote: The sync client is deprecated, please only start new projects using the async client. Feature contributions to the sync client will be rejected.\n\n## Requirements\nThis SDK uses [Poetry](https://python-poetry.org/docs/#installation) for packaging and dependency management:\n\n```\ncurl -sSL https://install.python-poetry.org | python3 -\npoetry install\n```\n\n## Unit testing\n```bash\nmake test\n```\n\n## E2E testing\nFirst, run a local testnet (run this from the root of aptos-core):\n\n```bash\ncargo run -p aptos -- node run-local-testnet --with-faucet --faucet-port 8081 --force-restart --assume-yes\n```\n\nNext, tell the end-to-end tests to talk to this locally running testnet:\n\n```bash\nexport APTOS_NODE_URL=\"http://127.0.0.1:8080/v1\"\nexport APTOS_FAUCET_URL=\"http://127.0.0.1:8081\"\n```\n\nFinally run the tests:\n\n```bash\nmake examples\n```\n\nNote: These end-to-end tests are tested against a node built from the same commit as part of CI, not devnet. For examples tested against devnet, see `developer-docs-site/static/examples/python/` from the root of the repo.\n\n## Autoformatting\n```bash\nmake fmt\n```\n\n## Generating types\nThe Python `openapi-python-client` tool cannot parse references. Therefore there are three options:\n\n- Use swagger-cli to dereference, gain a type explosion, and still have missing types\n- Live without missing types\n- Write a pure python implementation with no autogenerated code\n\nCurrently the team is moving forward with pure python, but leaves the following notes for the curious:\n\n```bash\nnpm install -g @apidevtools/swagger-cli\nswagger-cli bundle --dereference ../../../api/doc/v0/openapi.yaml -t yaml > openapi.yaml\npython3 -m openapi_python_client generate --path openapi.yaml\nmv aptos-dev-api-specification-client/aptos_dev_api_specification_client/ aptos_sdk/openapi\n```\n\n## Semantic versioning\nThis project follows [semver](https://semver.org/) as closely as possible\n\n[repo]: https://github.com/aptos-labs/aptos-core\n[pypi-image-version]: https://img.shields.io/pypi/v/aptos-sdk.svg\n[pypi-image-downloads]: https://img.shields.io/pypi/dm/aptos-sdk.svg\n[pypi-url]: https://pypi.org/project/aptos-sdk\n[discord-image]: https://img.shields.io/discord/945856774056083548?label=Discord&logo=discord&style=flat~~~~\n[discord-url]: https://discord.gg/aptosnetwork\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Aptos SDK",
"version": "0.7.0",
"project_urls": {
"Homepage": "https://github.com/aptos-labs/aptos-core/tree/main/ecosystem/python/sdk",
"Repository": "https://github.com/aptos-labs/aptos-core"
},
"split_keywords": [
"web3",
"sdk",
"aptos",
"blockchain"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "6fc38bd8118a28a698ff717cb6d615d0ed82c7c2404104b17f1b3da707ddce9a",
"md5": "ce2e466ca87cb3bc4c29bc1b72fc93d6",
"sha256": "031dd11355c4eb672aef6cee57921e150c4e29aa8b0b78b08323064f58855bb6"
},
"downloads": -1,
"filename": "aptos_sdk_zzf-0.7.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ce2e466ca87cb3bc4c29bc1b72fc93d6",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8.1,<4.0",
"size": 34990,
"upload_time": "2023-08-06T01:22:27",
"upload_time_iso_8601": "2023-08-06T01:22:27.976034Z",
"url": "https://files.pythonhosted.org/packages/6f/c3/8bd8118a28a698ff717cb6d615d0ed82c7c2404104b17f1b3da707ddce9a/aptos_sdk_zzf-0.7.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "322b114d6ce3056f1f587efbf0f39fc32d00ac6a43bd7255119186de89828c11",
"md5": "a7f3140b2d33d6a6e78abe60c5e2cb81",
"sha256": "ae52399cf5c779af294436d651a3395d1ce63452a84ae3184c4158516bc1cd24"
},
"downloads": -1,
"filename": "aptos_sdk_zzf-0.7.0.tar.gz",
"has_sig": false,
"md5_digest": "a7f3140b2d33d6a6e78abe60c5e2cb81",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8.1,<4.0",
"size": 30320,
"upload_time": "2023-08-06T01:22:30",
"upload_time_iso_8601": "2023-08-06T01:22:30.278363Z",
"url": "https://files.pythonhosted.org/packages/32/2b/114d6ce3056f1f587efbf0f39fc32d00ac6a43bd7255119186de89828c11/aptos_sdk_zzf-0.7.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-08-06 01:22:30",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "aptos-labs",
"github_project": "aptos-core",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "aptos-sdk-zzf"
}
JSON
