Metadata-Version: 2.1
Name: odecloud
Version: 0.13.8
Summary: Python client for https://server.odecloud.app
Home-page: https://gitlab.com/odetech/python_odecloud
License: MIT
Author: Vanielle
Author-email: vanielle@odecloud.com
Maintainer: OdeCloud
Maintainer-email: support@odecloud.com
Requires-Python: >=3.9,<4.0
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Dist: certifi (==2021.10.8)
Requires-Dist: charset-normalizer (==2.0.9)
Requires-Dist: idna (==3.3)
Requires-Dist: requests (==2.26.0)
Requires-Dist: urllib3 (==1.26.7)
Project-URL: Repository, https://gitlab.com/odetech/python_odecloud
Description-Content-Type: text/markdown

# Official OdeServer Python API's Client

## Getting Started & Usage

1. Installation:

- Use Poetry:
    ```sh
    $ poetry add odecloud
    ```
- Or, use Pip:
    ```sh
    $ pip install odecloud
    ```

2. Instantiate your connection to OdeCloud's API:

- If you don't know your client credentials:
    ```py
    api = Api('https://server.odecloud.app/api/v1') # All API calls will be made to this domain.
    api.login('your-email@here.com', 'your_password')
    ```

- If you already know your client credentials:<br>
    ```py
    api = Api(
        base_url='https://server.odecloud.app/api/v1', # All API calls will be made to this domain
        client_key='YOUR CLIENT KEY',
        client_secret='YOUR CLIENT SECRET',
    )
    ```

3. Now, any calls can be made to OdeCloud's API. Examples below:
    ```py
    api.comments.get(createdBy=random_user_id) # GET /api/v1/comments?createdBy=random_user_id/
    api.comments.post(data=expected_payload) # POST /api/v1/comments/
    api.comments(random_comment_id).patch(data=expected_payload) # PATCH /api/v1/comments/random_comment_id/
    api.comments(random_comment_id).delete() # DELETE /api/v1/comments/random_comment_id/
    ```
Happy coding!

## Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

## License
[MIT](https://choosealicense.com/licenses/mit/)
