Skip to main content

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.

Metadata

Release files for pydal 20250906.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pydal 20250906.1
File Size Uploaded
pydal-20250906.1.tar.gz 631.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for pydal 20250906.1
File Interpreter ABI Platform
pydal-20250906.1-py2.py3-none-any.whl Python 3, Python 2 none any Details

Total release size: 883.1 kB

Release files / pydal-20250906.1.tar.gz

Download URL pydal-20250906.1.tar.gz
Size 631.5 kB
Tags Source
SHA-256 checksum
How to use checksums
b68eed3a281a05c3eafe730a69ce9cc1187a4e57f971e5fccb8b3b2a49026b05
BLAKE2b-256 checksum
How to use checksums
e8d03a03dfefda43d8e1a1f0e65e663a58a64327d81b54f5769ce5ec1fd31cb5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.0

Release files / pydal-20250906.1-py2.py3-none-any.whl

Download URL pydal-20250906.1-py2.py3-none-any.whl
Size 251.6 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
3fe7727d50af8c45ead6a58ce5424892d3a9a5d808ab039a8a5e0e89cb18ac2d
BLAKE2b-256 checksum
How to use checksums
5262dfa3a1a899991df5863a640493bc3c9d723b070a8dfccf4d399382449dfa
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.0

Release history Release notifications | RSS feed

This release

20250906.1 This release

2 release files

19.8.18

1 release file

19.8.17

1 release file

19.8.16

1 release file

19.5.11

1 release file

19.5.10

1 release file

19.5.9

1 release file

19.5

2 release files

19.4

2 release files

17.11

2 release files

17.8

2 release files

17.7

2 release files

17.3

2 release files

17.1

2 release files

16.11

1 release file

16.9

1 release file

16.8

1 release file

16.7

1 release file

16.6.28

1 release file

16.6.20

1 release file

16.6.9

1 release file

16.6

1 release file

16.3

1 release file

15.12

1 release file

15.9

1 release file

15.07

1 release file

15.05

1 release file

15.03

1 release file

15.02

1 release file

0.12.25

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page