Metadata-Version: 2.4
Name: odouche
Version: 0.2.0
Summary: Unofficial Python client for Odoo.sh: projects, branches, builds and logs
Keywords: odoo,odoo.sh,api,client
Author: Avanserv
Author-email: Avanserv <avs@avanserv.com>
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Libraries
Classifier: Typing :: Typed
Requires-Dist: httpx2[ws]>=2.13.1
Requires-Dist: keyring>=25.7.0
Requires-Dist: wsproto>=1.2
Requires-Python: >=3.12
Project-URL: Homepage, https://github.com/avanserv/odouche
Project-URL: Documentation, https://avanserv.github.io/odouche/
Project-URL: Issues, https://github.com/avanserv/odouche/issues
Project-URL: Changelog, https://github.com/avanserv/odouche/blob/main/CHANGELOG.md
Description-Content-Type: text/markdown

# odouche

Unofficial Python client for [Odoo.sh](https://www.odoo.sh): projects, branches, builds and logs,
as typed models, for use in your own tools.

> This project is not affiliated with, endorsed by, or supported by Odoo S.A. Odoo.sh has no public
> API; this library talks to what the Odoo.sh web interface uses, which can change without notice.
> It acts with your own Odoo.sh access and nothing more, and staying within your agreement with
> Odoo is your responsibility. See [Unofficial status](https://avanserv.github.io/odouche/unofficial/).

**Status: pre-alpha.** Below 1.0, a minor release can break the API.

```bash
uv add odouche
```

```python
import odouche


with odouche.Client() as client:
    for project in client.projects():
        print(project.name, project.repository, project.url)
```

It logs in through a browser, lists projects, branches and builds, watches a build, reads and
follows build logs and triggers a rebuild. The session is kept in the OS keyring, or taken from
`ODOUCHE_SESSION` in headless use.

- [Guide](https://avanserv.github.io/odouche/library/)
- [API reference](https://avanserv.github.io/odouche/reference/)
- [Security](https://avanserv.github.io/odouche/security/)
