Skip to main content

A SQL/database library

Project description

master Travis CI Status PyPi package version Documentation Status

quma is a small SQL database library for Python and PyPy version 3.5 and higher. It maps object methods to SQL script files and supports SQLite, PostgreSQL, MySQL and MariaDB.

Unlike ORMs, it allows to write SQL as it was intended and to use all features the DBMS provides. As it uses plain SQL files you can fully utilize your database editor or IDE to author your queries.

It also provides a simple connection pool.


pip install quma

Quick Start

The full documentation is available at

Given a directory with some SQL scripts e. g.:

├── users
│    ├── all.sql
│    └── remove.sql
└── get_admin.sql

You can access these scripts after connecting to the database:

from quma import Database

db = Database('sqlite:///:memory:', '/path/to/sql/scripts')

db.execute('CREATE TABLE users ...')

with db.cursor as cur:
    all_users = cur.users.all()

    for user in all_users:


    admin = cur.get_admin()


quma is released under the MIT license.

Copyright © 2018 ebene fünf GmbH. All rights reserved.

Project details

Download files

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

Files for quma, version 0.1.0b1
Filename, size & hash File type Python version Upload date
quma-0.1.0b1-py3-none-any.whl (28.2 kB) View hashes Wheel py3
quma-0.1.0b1.tar.gz (21.7 kB) View hashes Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page