You need to connect to an Aptos node to use this library, or run one yourself locally.
Currently this is still in development and is unsuitable for directly interfacing with Aptos.
We use Poetry for packaging and dependency management:
curl -sSL https://install.python-poetry.org | python3
poetry update
make test
First, run a local testnet (run this from the root of aptos-core):
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:
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:
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.
make fmt
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:
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
This project follows semver as closely as possible