Skip to main content

pyDAL is a Database Abstraction Layer. It generates queries for SQlite, PotsgreSQL, MySQL, and other backends. It was originally part of the web2py frameworks but it is now an independent project. Example: db.define_table("thing",Field("name")) and db.thing.insert(name="Pizza")

Project description

pyDAL

pip version master-test Coverage Status API Docs Status

pyDAL is a pure Python Database Abstraction Layer.

It dynamically generates the SQL/noSQL in realtime using the specified dialect for the database backend, so that you do not have to write SQL code or learn different SQL dialects (the term SQL is used generically), and your code will be portable among different types of databases. What makes pyDAL different from most of the other DALs is the syntax: it maps records to python dictionaries, which is simpler and closer to SQL. Other famous frameworks instead strictly rely on an Object Relational Mapping (ORM) like the Django ORM or the SQL Alchemy ORM, that maps tables to Python classes and rows to Objects.

Historically pyDAL comes from the original web2py's DAL, with the aim of being compatible with any Python program. However, pyDAL nowadays is an indipendent package that can be used in any Python 3.7+ context.

Installation

You can install pyDAL using pip:

pip install pyDAL

Usage and Documentation

Here is a quick example:

>>> from pydal import DAL, Field
>>> db = DAL('sqlite://storage.db')
>>> db.define_table('thing', Field('name'))
>>> db.thing.insert(name='Chair')
>>> query = db.thing.name.startswith('C')
>>> rows = db(query).select()
>>> print rows[0].name
Chair
>>> db.commit()

The complete updated documentation is available on the py4web manual

What's in the box?

A little taste of pyDAL features:

  • Transactions
  • Aggregates
  • Inner Joins
  • Outer Joins
  • Nested Selects

Which databases are supported?

pyDAL supports the following databases:

  • SQLite
  • MySQL
  • PostgreSQL
  • MSSQL
  • FireBird
  • Oracle
  • DB2
  • Ingres
  • Sybase
  • Informix
  • Teradata
  • Cubrid
  • SAPDB
  • IMAP
  • MongoDB
  • Google Firestore

License

pyDAL is released under the BSD-3c License. For further details, please check the LICENSE file.

Project details


Release history Release notifications | RSS feed

Download files

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

Source Distribution

pydal-20251207.1.tar.gz (822.7 kB view details)

Uploaded Source

Built Distribution

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

pydal-20251207.1-py2.py3-none-any.whl (341.1 kB view details)

Uploaded Python 2Python 3

File details

Details for the file pydal-20251207.1.tar.gz.

File metadata

  • Download URL: pydal-20251207.1.tar.gz
  • Upload date:
  • Size: 822.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.0

File hashes

Hashes for pydal-20251207.1.tar.gz
Algorithm Hash digest
SHA256 571966ef15b1ae826e0338e3a24ab95bca5029755723ab1a79eb64337082e18b
MD5 21dcb22b0ec8f15e607bd5c6137fb1ff
BLAKE2b-256 538ff22822372765bf06a8b2aa9b0246a2f3b6abe21742b3608aa71939900cfe

See more details on using hashes here.

File details

Details for the file pydal-20251207.1-py2.py3-none-any.whl.

File metadata

  • Download URL: pydal-20251207.1-py2.py3-none-any.whl
  • Upload date:
  • Size: 341.1 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.0

File hashes

Hashes for pydal-20251207.1-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 fde417d44690fd2cb52623efddcc11781eb56f79f483f1934340240fdab5d847
MD5 88414c906a40948caadec3c83812d83d
BLAKE2b-256 3c2d12d77032ff7f67093a9082d132365b27da8c41effc52659b16b695b0187e

See more details on using hashes here.

Supported by

Image AWS Cloud computing and Security Sponsor Image Datadog Monitoring Image Depot Continuous Integration Image Fastly CDN Image Google Download Analytics Image Pingdom Monitoring Image Sentry Error logging Image StatusPage Status page