Metadata-Version: 2.4
Name: odouche-cli
Version: 0.3.0
Summary: osh: an unofficial command-line interface for Odoo.sh
Keywords: odoo,odoo.sh,cli
Author: Avanserv
Author-email: Avanserv <avs@avanserv.com>
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Environment :: Console
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: Typing :: Typed
Requires-Dist: odouche==0.3.0
Requires-Dist: rich>=15.0.0
Requires-Dist: typer>=0.27.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-cli

`osh`, an unofficial command-line interface for [Odoo.sh](https://www.odoo.sh), in the spirit of
`gcloud`, `aws` and `scw`. Built on the [`odouche`](https://pypi.org/project/odouche/) library.

> This project is not affiliated with, endorsed by, or supported by Odoo S.A. Odoo.sh has no public
> API; `osh` 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.** `osh` logs in, lists projects, branches and builds, watches a build, prints
and follows its logs and starts a rebuild.

```bash
uv tool install odouche-cli
```

From a checkout of the repository an Odoo.sh project builds:

```bash
osh auth login        # sign in with GitHub in a browser; the session goes to the keyring
osh branches list     # the project's branches, with their stage
git push
osh builds watch      # follow the build of the pushed commit, and exit with its result
osh logs              # the end of that build's log
```

Anywhere else, name the project and the branch:
`osh builds watch --project acme --branch feature-x`.

The [guide](https://avanserv.github.io/odouche/cli/) has the exit codes, the JSON output, the
environment variables and shell completion, and the
[reference](https://avanserv.github.io/odouche/cli-reference/) every command and option.
