Aito.ai Python SDK
Project description
- Info:
Check Github for the latest source code and documentation for more information.
- Maintainer:
Aito <admin@aito.ai>
About
The Aito Python SDK is an open-source library that helps you to integrate your Python application to Aito quicker and more efficiently.
The SDK also includes the Aito Command Line Interface (CLI) that enables you to interact with Aito using commands in your command-line shell, e.g: infer a table schema from a file or upload a file to Aito.
Support / Feedback
For issues with, questions about, or feedback, please join our support channels.
Installation
Aito Python SDK can be installed with pip
$ pip install aitoai
Check our installation guide for more information
Documentation
You will need sphinx installed to generate the documentation. Documentation can be generated by:
$ cd docs $ make clean html
Generated documentation can be found in the docs/build/html/* directory.
Testing
Install the required packages:
$ pip install -r requirements/build.txt $ pip install -r requirements/test.txt
You can use our test cli to run tests:
$ python -m tests -h
There are multiple test suites:
CLI suite:
$ python -m tests -v suite cli
SDK suite:
$ python -m tests -v suite sdk
SQL functions tests:
Test against Postgres:
$ python -m tests -v case sql_functions.test_connection.TestPostgresConnection $ python -m tests -v case sql_functions.test_cli_sql_functions.TestPostgresFunctions
Test against MySQL:
$ python -m tests -v case sql_functions.test_connection.TestMySQLConnection $ python -m tests -v case sql_functions.test_cli_sql_functions.TestMySQLFunctions
Build and test built package:
To build the package:
$ pip install -r requirements/deploy.txt $ ./scripts/deploy test.pypi --no-publish
The built wheel should be at `dist/`. To install:
$ pip install dist/aitoai-<version>.whl
To test the built package, create an environment variable `TEST_BUILT_PACKAGE` and run the above tests
Test the documentation:
To test the inline documentation:
$ python -m tests -v suite inline_docs
To test the code blocks in rst files:
$ cd docs $ make doctest
Contributing
Making changes
Add unittest to the appropriate test suite (e.g: test case for Aito Schema: tests/sdk/test_aito_schema.py) or create a new test suite inside the tests folder
Add documentation:
Inline documentation if applicable
Update .rst file in docs/source folder (e.g: Add a new Client function to docs/source/sdk.rst)
Add inline doc test if applicable (e.g: inline doc test for Aito Client: tests/inline_docs/test_client_inline_docs.py)
Check CircleCI and issue a PR
Deploy to production (scripts/deploy) with the appropriate version after the PR is reviewed
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.