Add a Docat API client/CLI tool

API endpoints are hard to remember and hard to read. A nice-to-have feature would be a Docat API client, which can be used with Python or with the command line.

The Docat CLI tool shall be runnable via a Docker container or via Pip

e.g. Tag:

# Previously:
$ curl -X PUT http://localhost:8000/api/PROJECT/VERSION/tags/latest
# After:
$ docat tag my-project 1.0.0 latest --url http://localhost:8000

Publish:

# Previously:
$ curl -X POST -F "file=@docs.zip" http://localhost:8000/api/PROJECT/VERSION
# After:
$ docat push my-project 1.0.0 ./docs.zip --url http://localhost:8000

(optional) Add a docat.yml config:

$ cat <<EOF > docat.yml
url: http://localhost:8000
project: my-project
EOF

$ docat push 1.0.0 ./docs.zip

or as API client

from docat import tag

tag("my-project", "1.0.0", "latest")

[fliiiix]

I close this since https://github.com/docat-org/docatl exists 🌮

[BrunnerLivio]

Good job @timofurrer. Would have been a “great job” if it was written in JavaScript but ok