|
2 | 2 | SQLAlchemy 2 Stubs
|
3 | 3 | ===================
|
4 | 4 |
|
5 |
| -These are the PEP-484 typing stubs for SQLAlchemy 1.4 and |
6 |
| -SQLAlchemy 2.0, as well as a mypy extension. |
| 5 | +These are PEP-484 typing stubs for `SQLAlchemy <https://www.sqlalchemy.org>` |
| 6 | +1.4 and 2.0. They are released concurrently along with |
| 7 | +a `Mypy extension <https://docs.sqlalchemy.org/en/14/orm/extensions/mypy.html>` |
| 8 | +which is designed to work with these stubs, which assists primarily in the |
| 9 | +area of ORM mappings. |
7 | 10 |
|
8 |
| -This package will be integrated within SQLAlchemy 2 itself |
9 |
| -as inline type annotations for SQLAlchemy 2.0's release. |
| 11 | +The stubs replace the use of the "sqlalchemy-stubs" package published by |
| 12 | +Dropbox. Differences include that these stubs are generated against |
| 13 | +1.4's API as well as some adjustments to the use of generics. |
10 | 14 |
|
| 15 | +This project should be considered **alpha level** and is not as mature |
| 16 | +as the Dropbox stubs for the initial release. |
11 | 17 |
|
12 |
| -For SQLAlchemy 1.4, the annotations are published here |
13 |
| -as separate stubs so that users who are relying upon |
14 |
| -the "sqlalchemy-stubs" package published by Dropbox can |
15 |
| -continue to do so. This package necessarily replaces |
16 |
| -sqlalchemy-stubs entirely, and will be in development |
17 |
| -throughout the 1.4 SQLAlchemy series. |
18 |
| - |
19 |
| -This project is **under consruction** right now and initial |
20 |
| -releases will be in the coming weeks of 2021. |
| 18 | +See the Mypy plugin documentation at https://docs.sqlalchemy.org/en/14/orm/extensions/mypy.html |
| 19 | +for an overview of how to use PEP-484 annotations with ORM mapped classes. |
21 | 20 |
|
22 | 21 |
|
23 | 22 |
|
|
0 commit comments