tahrir-api

Tahrir-API

API for interacting with the Tahrir database. Based on the Tahrir database model written by Ralph Bean. There are two classes that can be used in this module. The first is the TahrirDatabase class located in tahrir_api.dbapi and the second is the database model located in tahrir_api.model. The TahrirDatabase class is a high level way to interact with the database. The model is used for a slightly more low level way of interacting with the database. It allows for custom interactions with the database without having to use the TahrirDatabase class.

Development

System Requirements

Before getting started, ensure your system meets the following requirements:

Software Requirements

Python: 3.9 or higher
Poetry: Latest version for dependency management
Database: PostgreSQL 9.6+ (recommended) or SQLite (basic development)
Git: For version control

Operating System Requirement

Fedora Linux: Latest non-EOL versions

Note: Other distributions may work, but are not officially supported. The maintainers may not be able to assist with platform-specific issues on non-Fedora systems.

Project Setup

Ensure that the necessary packages are installed:

$ sudo dnf install -y python3 python3-pip python3-devel poetry gcc krb5-devel git

Clone your fork to the local storage and make it your current working directory:

$ git clone https://github.com/fedora-infra/tahrir-api.git
$ cd tahrir-api

Create a virtual environment and activate it for installing project dependencies:

$ python3 -m venv venv
$ source venv/bin/activate

Install project dependencies:

(venv) $ poetry check
(venv) $ poetry install

Database Setup

Create a directory for storing the Tahrir database snapshot:

(venv) $ cd ..
(venv) $ mkdir badges-database
(venv) $ cd badges-database

Download and extract the Tahrir database snapshot:

(venv) $ wget https://infrastructure.fedoraproject.org/infra/db-dumps/tahrir.dump.xz
(venv) $ unxz tahrir.dump.xz

Create directories for persistent data and the database dump:

(venv) $ mkdir data dump
(venv) $ mv tahrir.dump dump/

Pull the PostgreSQL container image:

(venv) $ podman pull docker.io/library/postgres:15

Start the database container (be sure to rename the username and paths based on your development environment):

(venv) $ podman run \
    --name badges-database \
    --env POSTGRES_USER=badgesdb \
    --env POSTGRES_PASSWORD=badgesdb \
    --env POSTGRES_DB=badgesdb \
    --env PGDATA=/var/lib/postgresql/data/pgdata \
    --volume /home/username/Projects/badges-database/data:/var/lib/postgresql/data:Z \
    --volume /home/username/Projects/badges-database/dump:/badgesdb:Z \
    --publish 5432:5432 \
    --restart unless-stopped \
    --detach docker.io/library/postgres:15

Once the database container has started, log in to the interactive shell using the password to begin importing the extracted dump:

(venv )$ podman pull docker.io/library/postgres:15
(venv )$ podman run \

Execute the following SQL commands to create roles, load the database dump, and grant the needed access:

badgesdb=# create role "tahrir" with inherit nocreatedb nocreaterole noreplication nosuperuser valid until 'infinity' login password 'tahrir';
badgesdb=# create role "tahrir-readonly" with nocreatedb inherit nocreaterole noreplication nosuperuser valid until 'infinity' login password 'tahrir-readonly';
badgesdb=# \i badgesdb/tahrir.dump
badgesdb=# grant connect on database tahrir to "tahrir";
badgesdb=# grant all on all tables in schema public to "tahrir";
badgesdb=# grant all on all sequences in schema public to "tahrir";
badgesdb=# revoke create on schema public from public;

Exit out of the interactive shell and log back in using the newly created credentials:

(venv )$ podman exec -ti badges-database psql --username badgesdb --password

Verify the database setup:

(venv )$ tahrir=> \dt+

Run the tests

Download and install tox:

(venv) $ cd ./tahrir-api
(venv) $ sudo dnf install tox

Run the tests with tox:

(venv) $ tox

Download files

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

Source Distribution

tahrir_api-1.5.6.tar.gz (50.8 kB view details)

Uploaded Aug 20, 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.

tahrir_api-1.5.6-py3-none-any.whl (58.8 kB view details)

Uploaded Aug 20, 2026 Python 3

File details

Details for the file tahrir_api-1.5.6.tar.gz.

File metadata

Download URL: tahrir_api-1.5.6.tar.gz
Upload date: Aug 20, 2026
Size: 50.8 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for tahrir_api-1.5.6.tar.gz
Algorithm	Hash digest
SHA256	`be8ad34a15f598ab69634de804912c1800ba40f026a0e3704392aa76a0985c84`
MD5	`49fc6bbcf92ad62ed2280b406f62fee2`
BLAKE2b-256	`afc4415f1856a081c4e9546fa90930cebcfc3d8efbee32a091223773f044f141`

See more details on using hashes here.

Provenance

The following attestation bundles were made for tahrir_api-1.5.6.tar.gz:

Publisher: main.yml on fedora-infra/tahrir-api

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: tahrir_api-1.5.6.tar.gz
- Subject digest: be8ad34a15f598ab69634de804912c1800ba40f026a0e3704392aa76a0985c84
- Sigstore transparency entry: 2531944991
- Sigstore integration time: Aug 20, 2026
Source repository:
- Permalink: fedora-infra/tahrir-api@8773a0a9c57fd9c5c273332c55b6b5a2cc422acf
- Branch / Tag: refs/tags/1.5.6
- Owner: https://github.com/fedora-infra
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: main.yml@8773a0a9c57fd9c5c273332c55b6b5a2cc422acf
- Trigger Event: push