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
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.
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
Built Distribution
File details
Details for the file pydal-20250501.2.tar.gz.
File metadata
- Download URL: pydal-20250501.2.tar.gz
- Upload date:
- Size: 623.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.12.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 58217aa7360c7f5116339f2818e8ad5c795d263f5132aac3f12cbc4c7a9fcd3d |
|
| MD5 | 4878267e5305cbe1c732cdb5f55fce87 |
|
| BLAKE2b-256 | 313772a7c4b2011284f555fc33b23e28b88cea650be567520a16d07d0504911b |
File details
Details for the file pydal-20250501.2-py2.py3-none-any.whl.
File metadata
- Download URL: pydal-20250501.2-py2.py3-none-any.whl
- Upload date:
- Size: 247.2 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.12.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 5ef957e0775d8a89d556eb34cef374a2e73e8ab8db8330657c7859e8aba86756 |
|
| MD5 | c618ad4351a67f2628e7c3a2a894905e |
|
| BLAKE2b-256 | 7ff3d2d791a5bbf714183f82ee3a358517ff14c98af489ce9d4d50fc4ff29d52 |
