AYON server API
Python client for connection server. The client is using REST and GraphQl to communicate with server with requests module.
AYON Python api should support connection to server with raw REST functions and prepared functionality for work with entities. Must not contain only functionality that can be used with core server functionality.
Module support singleton connection which is using AYON_SERVER_URL and AYON_API_KEY environment variables as source for connection. The singleton connection is using ServerAPI object. There can be created multiple connection to different server at one time, for that purpose use ServerAPIBase object.
Install
AYON python api is available on PyPi:
pip install ayon-python-api
For development purposes you may follow build guide to build and install custom wheels.
Cloning the repository
Repository does not have submodules or special cases. Clone is simple as:
git clone git@github.com:ynput/ayon-python-api.git
Build wheel
For wheel build is required a wheel module from PyPi:
pip install wheel
Open terminal and change directory to ayon-python-api repository and build wheel:
cd <REPOSITORY ROOT>/ayon-python-api
python setup.py sdist bdist_wheel
Once finished a wheel should be created in ./dist/ayon_python_api-<VERSION>-py3-none-any.
Wheel installation
The wheel file can be used to install using pip:
pip install <REPOSITORY ROOT>/dist/ayon_python_api-<VERSION>-py3-none-any
If pip complain that ayon-python-api is already installed just uninstall existing one first:
pip uninstall ayon-python-api
TODOs
- Find more suitable name of
ServerAPIobjects (right now is usedconorconnection) - Add all available CRUD operation on entities using REST
- Add folder and task changes to operations
- Enhance entity hub
- Missing docstrings in EntityHub -> especially entity arguments are missing
- Better order of arguments for entity classes
- Move entity hub to first place
- Skip those which are invalid for the entity and fake it for base or remove it from base
- Entity hub should use operations session to do changes
- Entity hub could also handle 'product', 'version' and 'representation' entities
- Missing 'status' on folders
- Missing assignees on tasks
- Pass docstrings and arguments definitions from
ServerAPImethods to global functions
- Split
ServerAPIinto smaller chunks (somehow), the class has 4k+ lines of code - Add .pyi stub for ServerAPI
- Missing websockets connection
5 maintainers
Metadata
5 maintainers
Release files for ayon-python-api 1.2.24
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| ayon_python_api-1.2.24.tar.gz | 182.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| ayon_python_api-1.2.24-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 361.0 kB
Release files / ayon_python_api-1.2.24.tar.gz
| Download URL | ayon_python_api-1.2.24.tar.gz |
|---|---|
| Size | 182.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7ee42f85f92d5a84eb698dc315e722f6fba088109bbc895f50789c6cf8f335f3
|
|
BLAKE2b-256 checksum How to use checksums |
8e0c1b0a4b2f2b644544dddc918f8060e86a757215d4209f9409bf5c658eaf51
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / ayon_python_api-1.2.24-py3-none-any.whl
| Download URL | ayon_python_api-1.2.24-py3-none-any.whl |
|---|---|
| Size | 178.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c872dc68263933bbf1459716a0d487d73a6808a1db4e418d3cd55df52218d2a1
|
|
BLAKE2b-256 checksum How to use checksums |
5adc350642c8025009bbde950c3c0e4a69e7a2737a2c2221279bba2fb906edae
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
