README.md

Pygitea

Gitea API wrapper for Python (3 only).

Install

pip install git+https://github.com/h44z/pygitea

Basic usage

import pygitea

api = pygitea.API('http://192.168.100.10:3000')
api.get('/version')
api.get('/orgs/an-organisation/members')

Authentification token

Setup authentification token:

import pygitea
api = pygitea.API('http://192.168.100.10:3000', token="AUTH-TOKEN")
api.delete('/admin/users/arount')

Main API methods

api.get('route')   # Send GET query to route
api.post('route')  # Send POST query to route
api.patch('route') # Send PATCH query to route
api.put('route')   # Send PUT query to route

Alternative API method

# Send GET query to route with parameters
api.call('route', method='get', params={"body": "Egg, bacon, sausages and SPAM")

Exceptions

Exceptions are raised before sending query. If API respond error message no exception will be raised (for the moment, at least)

Authentification token

If auth token is not set when you are trying to access to a protected resource:

api = pygitea.API('http://192.168.100.10:3000')
api.delete('/admin/users/arount')

pygitea.PygiteaRequestException: Resource '/admin/users/{username}' require an authentification token.

Resource do not exists

api.get('/fake/route')

pygitea.PygiteaRequestException: Path '/fake/route' did not match with any resource

Method do not exists for resource

api.delete('/markdown')

pygitea.PygiteaRequestException: Resource '/markdown' did not expect method DELETE