py-gitea

A simple API client for Gitea > 1.24 based on the idea that passing around dictionaries and strings is disgusting and needs to be wrapped in something safe. So, the whole implementation is focused on making access and working with Organizations, Teams, Repositories and Users as pain free as possible.

Most functions should be covered by tests or should be in use (somewhere) so things should work as expected. Note that not the full Swagger-API is accessible.

Originally forked from https://github.com/m301/py-gitea.

Usage

First get a gitea object wrapping access and authentication (via an api token) for your gitea instance:

from gitea import *

gitea = Gitea(URL, TOKEN)

Operations like requesting the Gitea version or authentication user can be done directly from the gitea object:

print("Gitea Version: " + gitea.get_version())
print("API-Token belongs to user: " + gitea.get_user().username)

Adding entities like Users, Organizations, ... also is done via the gitea object.

user = gitea.create_user("Test Testson", "test@test.test", "password")

All operations on entities in gitea are then accomplished via the according wrapper objects for those entities. Each of those objects has a .request method that creates an entity according to your gitea instance

other_user = User.request(gitea, "OtherUserName")
print(other_user.username)

or can be requested from other entities.

orgs = user.get_orgs()
print(f"{user.name} is in orgarnisations {orgs}")

Note that the fields of the User, Organization,... classes are dynamically created at runtime, and thus not visible during divelopment. Refer to the Gitea-API documentation for the fields names.

Fields that can not be altered via gitea-api, are read only. After altering a field, the .commit method of the according object must be called to synchronize the changed fields with your gitea instance.

org = Organization.request(gitea, test_org)
org.description = "some new description"
org.location = "some new location"
org.commit()

An entity in gitea can be deleted by calling delete.

org.delete()

All entity objects do have methods to execute some of the requests possible though the gitea-api:

org = Organization.request(gitea, ORGNAME)
teams = org.get_teams()
for team in teams:
    repos = team.get_repos()
    for repo in repos:
        print(repo.name)

If something is missing, feel free to add it :).

Installation

Use pip install py-gitea to install.

Tests

Tests can be run with:

python3 -m pytest test_api.py

Make sure to have a gitea-instance running on http://localhost:3000, and an admin-user token at .token. The admin user must be named test, with email secondarytest@test.org.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

py_gitea-0.3.3.tar.gz (26.0 kB view details)

Uploaded Aug 10, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

py_gitea-0.3.3-py3-none-any.whl (20.6 kB view details)

Uploaded Aug 10, 2026 Python 3

File details

Details for the file py_gitea-0.3.3.tar.gz.

File metadata

Download URL: py_gitea-0.3.3.tar.gz
Upload date: Aug 10, 2026
Size: 26.0 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for py_gitea-0.3.3.tar.gz
Algorithm	Hash digest
SHA256	`ced304bbcf3e897e5b26894b138b0235311aa10f7bf1bc9a5890f0801b54457f`
MD5	`9785d809089b526bf4b82d771a8b3ef9`
BLAKE2b-256	`6272c2bbb3ee7538b476d7fc87faec21e6e843d20a1c9ac0b1fba3e3a9172b09`

See more details on using hashes here.

Provenance

The following attestation bundles were made for py_gitea-0.3.3.tar.gz:

Publisher: publish_pypi.yml on Langenfeld/py-gitea

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: py_gitea-0.3.3.tar.gz
- Subject digest: ced304bbcf3e897e5b26894b138b0235311aa10f7bf1bc9a5890f0801b54457f
- Sigstore transparency entry: 2408584508
- Sigstore integration time: Aug 10, 2026
Source repository:
- Permalink: Langenfeld/py-gitea@cca5364a1d6da55c3e65d32124e900f7e5494d53
- Branch / Tag: refs/heads/release
- Owner: https://github.com/Langenfeld
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish_pypi.yml@cca5364a1d6da55c3e65d32124e900f7e5494d53
- Trigger Event: push