rakko-orm 1.0.0a0__tar.gz

rakko_orm-1.0.0a0/ASSETS.md

@@ -0,0 +1,12 @@
+<!-- Copyright (c) 2026 ropmyung (Rakko ORM modifications and additions).
+Derived from Tortoise ORM; maintained and modified for Rakko ORM.
+SPDX-License-Identifier: Apache-2.0 -->
+
+# Rakko artwork
+
+`docs/_static/rakko-logo.png` is new Rakko artwork generated with OpenAI image
+generation for this project, then saved as a transparent PNG. The generation
+prompt is retained in `docs/_static/rakko-logo.prompt.txt`.
+It replaces the inherited project logo and does not contain Tortoise branding.
+The project distributes this asset under Apache-2.0 to the extent applicable
+rights permit. Generated artwork does not establish exclusive trademark rights.

rakko_orm-1.0.0a0/CHANGELOG.rst

@@ -0,0 +1,54 @@
+.. Copyright (c) 2026 ropmyung (Rakko ORM modifications and additions).
+   Derived from Tortoise ORM; maintained and modified for Rakko ORM.
+   SPDX-License-Identifier: Apache-2.0
+
+.. _changelog:
+
+Rakko ORM changelog
+===================
+
+1.0.0-alpha — first Rakko release
+---------------------------------
+
+Maintained by ropmyung. The Python distribution version is ``1.0.0a0``.
+
+This file summarizes Rakko-specific changes. The project began as a fork of
+`Tortoise ORM <https://github.com/tortoise/tortoise-orm>`_; upstream releases
+are not presented as Rakko release history.
+
+Model and query API
+~~~~~~~~~~~~~~~~~~~
+
+* Require Python 3.12+ and use modern generic syntax.
+* Expose class fields as ``Query[Model, Value]`` and instance fields as values.
+* Replace the public ``Q``/keyword-filter pipeline with model-bound criteria
+  built on native ``pypika_tortoise`` expressions.
+* Preserve constructor parameters through ``ParamSpec`` in query chains,
+  ``create``, ``update`` and both upsert methods.
+* Accept field references in projections, sorting, grouping, relation loading,
+  bulk field lists, instance updates and refreshes. Named projections accept SQL expressions.
+* Add ``@meta``/``MetaOption`` metadata and ``@reverse_relation`` accessors.
+
+Fields and execution
+~~~~~~~~~~~~~~~~~~~~
+
+* Separate automatic integer factories from ordinary fields; a primary key
+  alone no longer enables auto-increment.
+* Support signed/unsigned integer sizes and MySQL UNSIGNED/AUTO_INCREMENT SQL.
+* Preserve nullable Text/JSON typing, async drivers, pooling and transactions.
+* Keep updates partial and upsert lookup separate from creation values;
+  preserve uniqueness-race retries and explicit transaction connections.
+* Correct renamed-column handling in bulk conflict SQL and related partial selection.
+
+Project and validation
+~~~~~~~~~~~~~~~~~~~~~~
+
+* Establish Rakko's sea-otter identity and ocean-blue documentation.
+* Replace inherited release notes and stale examples with concise Rakko guides.
+* Add runnable examples plus runtime, SQL-generation and Pyright regression tests.
+
+Next work
+~~~~~~~~~
+
+An explicit JOIN builder, broader live-database validation, and adaptation of
+inherited migration/integration tooling remain follow-up work.

rakko_orm-1.0.0a0/CONTRIBUTORS.rst

@@ -0,0 +1,86 @@
+.. Copyright (c) 2026 ropmyung (Rakko ORM modifications and additions).
+   Derived from Tortoise ORM; maintained and modified for Rakko ORM.
+   SPDX-License-Identifier: Apache-2.0
+
+Rakko ORM acknowledgements
+==========================
+
+Rakko is independently maintained and began as a fork of Tortoise ORM.
+The original contributor list below is retained to credit upstream work.
+See ``NOTICE.txt`` and ``LICENSE.txt`` for provenance and license text.
+
+======
+Thanks
+======
+
+Contributors
+============
+
+* Andrey Bondar ``@abondar``
+* Nickolas Grigoriadis ``@grigi``
+* ``@etzelwu``
+* Alexander Lyon ``@arlyon``
+* Florimond Manca ``@florimondmanca``
+* Vitali Rebkavets ``@REVIMI``
+* Shlomy Balulu ``@shaloba``
+* Klaas Nebuhr ``@FirstKlaas``
+* Harsha Narayana ``@harshanarayana``
+* Terra Brown ``@superloach``
+* Nguyễn Hồng Quân ``@hongquan``
+* Mateusz Bocian ``@mrstork``
+* Vladimir Urushev ``@pilat``
+* Adam Wallner ``@wallneradam``
+* Zoltán Szeredi ``@zoliszeredi``
+* Rebecca Klauser ``@svms1``
+* Sina Sohangir ``@sinaso``
+* Weiming Dong ``@dongweiming``
+* ``@AEnterprise``
+* Jinlong Peng ``@long2ice``
+* Sang-Heon Jeon ``@lntuition``
+* Jong-Yeop Park ``@pjongy``
+* ``@sm0k``
+* Lev Gorodetskiy ``@droserasprout``
+* Hao Gong  ``@dongfangtianyu``
+* Peng Gao ``@Priestch``
+* Mykola Solodukha ``@TrDex``
+* Seo Jiyeon ``jiyeonseo``
+* Blake Watters ``blakewatters``
+* Alexey Tylindus ``@mirrorrim``
+* Rodrigo Oliveira ``@allrod5``
+* ``@SnkSynthesis``
+* Alex Sinichkin ``@AlwxSin``
+* ``@Yolley``
+* Weiliang Li ``@kigawas``
+* Bogdan Evstratenko ``@evstratbg``
+* Mike Ryan ``@devsetgo``
+* Eugene Dubovskoy ``@drjackild``
+* Lương Quang Mạnh ``@lqmanh``
+* Mykyta Holubakha ``@Hummer12007``
+* Tiago Barrionuevo ``@tiabogar``
+* Isaque Alves ``@isaquealves``
+* Vinay Karanam ``@vinayinvicible``
+* Aleksandr Rozum ``@rozumalex``
+* Mojix Coder ``@MojixCoder``
+* Paul Serov ``@thakryptex``
+* Stanislav Zmiev ``@Ovsyanka83``
+* Waket Zheng ``@waketzheng``
+* Yuval Ben-Arie ``@yuvalbenarie``
+* Stephan Klein ``@privatwolke``
+* ``@WizzyGeek``
+* Ivan Pakeev ``@ipakeev``
+* Abdeldjalil Hezouat ``@Abdeldjalil-H``
+* Andrea Magistà ``@vlakius``
+* Daniel Szucs ``@Quasar6X``
+* Rui Catarino ``@ruitcatarino``
+* Lance Moe ``@lancemoe``
+* Markus Beckschulte ``@markus-96``
+* Frederic Aoustin ``@fraoustin``
+* Ludwig Hähne ``@pankrat``
+* Christian Tanul ``@scriptogre``
+* Qian Chen ``@shkey``
+* Varun Chawla ``@veeceey``
+
+Special Thanks
+==============
+
+Huge thanks to https://github.com/kayak/pypika for all heavy lifting.

rakko_orm-1.0.0a0/LICENSE.txt

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "{}"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2018 Andrey Bondar
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

rakko_orm-1.0.0a0/LICENSE_REVIEW.md

@@ -0,0 +1,40 @@
+<!-- Copyright (c) 2026 ropmyung (Rakko ORM modifications and additions).
+Derived from Tortoise ORM; maintained and modified for Rakko ORM.
+SPDX-License-Identifier: Apache-2.0 -->
+
+# Distribution license review
+
+Reviewed for Rakko ORM 1.0.0-alpha (`1.0.0a0`), maintained by ropmyung.
+
+Rakko is derived from Tortoise ORM and retains Apache-2.0. The review uses the
+[Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0), especially
+sections 4 and 6, and the
+[upstream license](https://github.com/tortoise/tortoise-orm/blob/develop/LICENSE.txt).
+
+| Requirement | Distribution treatment |
+| --- | --- |
+| Section 4(a): include the license | The original `LICENSE.txt` is included in source and wheel distributions. |
+| Section 4(b): identify modifications in modified files | Maintained source, documentation and configuration files carry Rakko modification notices. |
+| Section 4(c): preserve applicable upstream attribution | Original license copyright and existing notices are retained; `CONTRIBUTORS.rst` preserves upstream acknowledgements. |
+| Section 4(d): retain applicable upstream NOTICE contents, if supplied | No original NOTICE is present in this checkout. The upstream `develop` root inspected during this review lists `LICENSE.txt` and no NOTICE. Rakko's `NOTICE.txt` is explicitly identified as a new project notice. |
+| Section 6: trademark rights are not granted | Separate Rakko branding is used; README and NOTICE describe the fork without implying endorsement. |
+
+The original license SHA-256 before and after release preparation is:
+
+```text
+f79cadf1835446bf346fc990e2986a795f00a10e811b80a4d1a20e7c50844537
+```
+
+The checkout has no Git history identifying its exact upstream commit. Current
+upstream inspection cannot establish the contents of that original snapshot;
+if it is recovered and contains an applicable NOTICE or additional notices,
+retain those as well. This report records the available evidence rather than
+claiming a complete historical provenance audit.
+
+Dependencies are declared separately and are not vendored into the wheel.
+Their own licenses continue to apply when they are installed or redistributed;
+Rakko's license does not replace them. New artwork provenance is in `ASSETS.md`.
+
+The Apache warranty disclaimer and limitation of liability remain unchanged.
+This is a record of the release's license handling, not a legal opinion or a
+claim that upstream sponsors or certifies Rakko ORM.

rakko_orm-1.0.0a0/NOTICE.txt

@@ -0,0 +1,22 @@
+Rakko ORM
+
+Copyright 2018 Andrey Bondar (original Tortoise ORM).
+Copyright 2026 ropmyung (Rakko ORM modifications and additions).
+
+Rakko ORM is an independently maintained project derived from Tortoise ORM.
+It includes code originally developed by Tortoise ORM contributors:
+https://github.com/tortoise/tortoise-orm
+
+Original project authors include Andrey Bondar, Nickolas Grigoriadis and
+long2ice. The retained upstream contributor acknowledgements appear in
+CONTRIBUTORS.rst. Existing source notices and the Apache License 2.0 text
+in LICENSE.txt are retained.
+
+Rakko-specific changes include typed model and field declarations,
+model-bound PyPika expressions, query constructor parameter inference,
+field-reference query APIs, explicit automatic integer fields, metadata
+declarations, documentation and branding. See CHANGELOG.rst.
+
+This notice was created for Rakko ORM; it is not an upstream NOTICE file.
+Rakko ORM is not an official Tortoise ORM release and does not imply upstream
+endorsement. The Apache License does not grant rights to upstream trademarks.

rakko_orm-1.0.0a0/PKG-INFO

@@ -0,0 +1,114 @@
+Metadata-Version: 2.4
+Name: rakko-orm
+Version: 1.0.0a0
+Summary: An independent async Python ORM with typed fields and PyPika-powered queries
+Keywords: sql,mysql,postgres,psql,sqlite,aiosqlite,asyncpg,relational,database,rdbms,orm,object mapper,async,asyncio,aio,psycopg
+Author: ropmyung
+License-Expression: Apache-2.0
+License-File: CONTRIBUTORS.rst
+License-File: LICENSE.txt
+License-File: NOTICE.txt
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Programming Language :: PL/SQL
+Classifier: Framework :: AsyncIO
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Database
+Classifier: Typing :: Typed
+Classifier: Operating System :: POSIX
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: Microsoft :: Windows
+Requires-Python: >=3.12
+Requires-Dist: pypika-tortoise<1.0.0,>=0.6.5
+Requires-Dist: iso8601<3.0.0,>=2.1.0; python_version < "4.0"
+Requires-Dist: aiosqlite<1.0.0,>=0.16.0
+Requires-Dist: anyio
+Provides-Extra: ipython
+Requires-Dist: ipython; extra == "ipython"
+Requires-Dist: nest-asyncio>=1.6.0; extra == "ipython"
+Provides-Extra: ptpython
+Requires-Dist: ptpython>=3.0.0; extra == "ptpython"
+Provides-Extra: accel
+Requires-Dist: ciso8601; sys_platform != "win32" and implementation_name == "cpython" and extra == "accel"
+Requires-Dist: uvloop; sys_platform != "win32" and implementation_name == "cpython" and extra == "accel"
+Requires-Dist: orjson; extra == "accel"
+Provides-Extra: asyncpg
+Requires-Dist: asyncpg; extra == "asyncpg"
+Provides-Extra: aiomysql
+Requires-Dist: aiomysql; extra == "aiomysql"
+Provides-Extra: asyncmy
+Requires-Dist: asyncmy<1.0.0,>=0.2.12; extra == "asyncmy"
+Provides-Extra: psycopg
+Requires-Dist: psycopg[binary,pool]<4.0.0,>=3.0.12; extra == "psycopg"
+Provides-Extra: asyncodbc
+Requires-Dist: asyncodbc<1.0.0,>=0.1.1; python_version < "4.0" and extra == "asyncodbc"
+Description-Content-Type: text/markdown
+
+<!-- Copyright (c) 2026 ropmyung (Rakko ORM modifications and additions).
+Derived from Tortoise ORM; maintained and modified for Rakko ORM.
+SPDX-License-Identifier: Apache-2.0 -->
+
+# Rakko ORM
+
+**Typed queries. Async by nature.**
+
+Rakko ORM is an independent asynchronous Python ORM maintained by **ropmyung**.
+Release **1.0.0-alpha** uses the Python package version **1.0.0a0** and requires
+Python **3.12 or newer**. Its name means sea otter (해달).
+
+Rakko began as a fork of [Tortoise ORM](https://github.com/tortoise/tortoise-orm).
+It retains the async database foundation while redesigning field typing,
+model metadata and query composition. It is developed as a separate project.
+
+```python
+import asyncio
+
+from rakko import Field, Model, fields
+from rakko.context import TortoiseContext
+
+
+class User(Model):
+    id: Field[int] = fields.AutoField()
+    name: Field[str] = fields.CharField(100)
+    age: Field[int | None] = fields.IntField(null=True)
+
+
+async def main() -> None:
+    async with TortoiseContext() as context:
+        await context.init(db_url="sqlite://:memory:", modules={"models": [__name__]})
+        await context.generate_schemas()
+        user = await User.create(name="Ada", age=20)
+        await User.filter(User.id == user.id).update(age=21)
+        print(await User.filter(User.age >= 18).values(User.name, User.age))
+
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+- Class fields are model-bound query expressions; instance fields are Python values.
+- Conditions use Python comparisons and `&`, `|`, `~`; filtering takes one criterion.
+- Projections, sorting, grouping and relation loading accept field references.
+- `ParamSpec` preserves model constructor names and types through query chains and upserts.
+- Automatic integer fields are explicit; setting a primary key alone does not enable auto-increment.
+- MySQL signed/unsigned integers, async drivers, connection pools and transactions are retained.
+
+Ordinary constructor parameters are optional in static signatures; runtime
+validation and database constraints still apply. Updates modify supplied fields.
+SQL expressions use `pypika_tortoise`. An explicit JOIN builder and adaptation
+of inherited migration/integration tooling remain future work.
+
+SQLite works with the base package. MySQL drivers are available through the
+`aiomysql` and `asyncmy` extras. PostgreSQL drivers use `asyncpg` or `psycopg`.
+The source distribution includes documentation sources, examples and tests.
+
+Rakko ORM is distributed under the
+[Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0).
+`LICENSE.txt`, `NOTICE.txt` and `CONTRIBUTORS.rst` accompany distributions and
+preserve upstream licensing and credits. No upstream endorsement is implied.

rakko_orm-1.0.0a0/README.md

@@ -0,0 +1,125 @@
+<!-- Copyright (c) 2026 ropmyung (Rakko ORM modifications and additions).
+Derived from Tortoise ORM; maintained and modified for Rakko ORM.
+SPDX-License-Identifier: Apache-2.0 -->
+
+<p align="center">
+  <img src="docs/_static/rakko-logo.png" width="160" height="160" alt="Rakko ORM — a sea otter in an ocean wave">
+</p>
+
+# Rakko ORM
+
+**Typed queries. Async by nature.**
+
+**1.0.0-alpha** · Python package version **1.0.0a0** · Maintained by **ropmyung**.
+
+Rakko ORM is an asynchronous Python ORM built around typed model fields,
+natural Python conditions and MySQL-friendly database access.
+Its name comes from *rakko*, the Japanese word for sea otter (해달).
+
+```python
+members = await Member.filter(
+    (Member.age >= 18) & (Member.guild == guild)
+).order_by(-Member.age).values(Member.name, Member.age)
+```
+
+Rakko began as a fork of [Tortoise ORM](https://github.com/tortoise/tortoise-orm).
+It is now developed as a separate project with its own package, API direction,
+documentation and identity. Tortoise's async database foundation is retained;
+Rakko redesigns model typing, field declarations and query composition.
+
+## What changes
+
+- **Fields with two views:** `Member.age` is a typed query expression; `member.age` is a Python value.
+- **Python conditions:** combine comparisons with `&`, `|` and `~`, then pass one model-bound `Criterion`.
+- **Field references throughout:** projections, ordering, grouping, relations and bulk field lists use model attributes.
+- **Constructor-aware calls:** `ParamSpec` preserves model parameter names and value types through query chains and upserts.
+- **Explicit automatic integers:** `AutoField`, `BigAutoField`, `SmallAutoField` and `TinyAutoField` are separate from ordinary integers. A primary key alone does not enable auto-increment.
+- **MySQL support:** async drivers, pooling, transactions and signed/unsigned integer fields.
+- **Model metadata and reverse accessors:** `@meta`, `MetaOption` and `@reverse_relation` provide explicit declarations.
+
+SQL construction uses `pypika_tortoise`; database connections and transaction
+management build on the existing async backend adapters.
+
+## Try this checkout
+
+Python **3.12 or newer** is required. These commands install and run the local
+project; they do not assume that a Rakko release is available on PyPI.
+
+```powershell
+uv sync --group test
+uv run -m examples.basic
+uv run -m examples.queries
+uv run -m examples.relations
+uv run -m examples.bulk_and_transactions
+```
+
+The examples use isolated in-memory SQLite databases. To preview MySQL SQL,
+including UNSIGNED and AUTO_INCREMENT, without connecting to a server:
+
+```powershell
+uv run --extra aiomysql -m examples.mysql_sql
+```
+
+## A small application
+
+```python
+import asyncio
+
+from rakko import Field, Model, fields
+from rakko.context import TortoiseContext
+
+
+class User(Model):
+    id: Field[int] = fields.AutoField()
+    name: Field[str] = fields.CharField(100)
+    age: Field[int | None] = fields.IntField(null=True)
+
+
+async def main() -> None:
+    async with TortoiseContext() as context:
+        await context.init(db_url="sqlite://:memory:", modules={"models": [__name__]})
+        await context.generate_schemas()
+
+        user = await User.create(name="Ada")
+        await User.filter(User.id == user.id).update(age=21)
+        print(await User.all().values(User.name, User.age))
+
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+Ordinary model parameters are optional in static constructor signatures while
+field names and value types remain checked. Runtime validation and database
+constraints still determine whether a record can be saved. Updates change only
+the explicitly supplied fields. `create`, `get_or_create` and `update_or_create`
+accept model arguments directly; upsert criteria are used only for lookup.
+
+## Read and contribute
+
+- [Getting started](docs/getting_started.rst)
+- [Model and field declarations](docs/models.rst)
+- [Query API](docs/query.rst)
+- [Changes from Tortoise ORM](docs/migration_guide.rst)
+- [Runnable examples](examples/README.md)
+- [Development and contribution guide](docs/CONTRIBUTING.rst)
+- [Concise changelog](CHANGELOG.rst)
+- [Release preparation and publishing](RELEASING.md)
+- [License review](LICENSE_REVIEW.md)
+
+```powershell
+uv run --all-groups --extra asyncpg --extra psycopg pytest -q
+uv run --group docs sphinx-build -W --keep-going -b html docs docs/_build/html
+```
+
+The test suite exercises SQLite execution, generated MySQL/PostgreSQL SQL and
+Pyright typing contracts. The migration framework and additional integrations
+are retained from the original codebase and are still being adapted to Rakko's API.
+
+## Origins and license
+
+Rakko ORM is distributed under [Apache License 2.0](LICENSE.txt).
+The original [Tortoise ORM](https://github.com/tortoise/tortoise-orm) authors and
+contributors are acknowledged in [NOTICE.txt](NOTICE.txt) and
+[CONTRIBUTORS.rst](CONTRIBUTORS.rst). Upstream release history is separate from
+[Rakko's changelog](CHANGELOG.rst).