django-pyturso 0.1.0__tar.gz

django_pyturso-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 B.T. Franklin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

django_pyturso-0.1.0/PKG-INFO

@@ -0,0 +1,77 @@
+Metadata-Version: 2.4
+Name: django-pyturso
+Version: 0.1.0
+Summary: A Django database backend for the embedded Turso database engine
+Author: B.T. Franklin
+License-Expression: MIT
+License-File: LICENSE
+License-File: THIRD_PARTY_NOTICES.md
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Framework :: Django :: 6.0
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Typing :: Typed
+Requires-Python: >=3.14
+Requires-Dist: Django>=6.0.7
+Requires-Dist: pyturso>=0.7.0
+Description-Content-Type: text/markdown
+
+# django-pyturso
+
+![django-pyturso banner](https://raw.githubusercontent.com/btfranklin/django-pyturso/main/.github/social%20preview/django_pyturso_social_preview.jpg "django-pyturso")
+
+`django-pyturso` is a Django database backend for the embedded Turso database
+engine exposed by `pyturso`. It will let a Django project use its ordinary ORM,
+migrations, forms, admin, and transaction APIs against a local Turso database
+file.
+
+This repository is deliberately scoped to embedded, local Turso. It does not
+provide Turso Cloud access, libSQL-over-HTTP support, replication, sync, or a
+project-specific compatibility layer.
+
+## Status
+
+The pre-release backend is implemented and covered by focused tests for ORM,
+migrations, transactions, Django integration, driver behavior, and package
+installation. Publication remains a separate, explicitly authorized action.
+
+The v1 contract intentionally excludes writing non-NULL Django `BinaryField`
+values because the stable `pyturso` 0.7 line does not expose the required PEP
+249 `Binary()` constructor. The backend deliberately does not patch or wrap the
+real `turso` module. See the compatibility document before evaluating the
+package.
+
+## Quickstart
+
+```bash
+pdm install --group dev
+pdm run check
+```
+
+Configure a Django database with no external service:
+
+```python
+DATABASES = {
+    "default": {
+        "ENGINE": "django_pyturso",
+        "NAME": BASE_DIR / "db.sqlite3",
+    }
+}
+```
+
+The package requires CPython 3.14 or later and targets Django 6 and embedded
+local Turso through `pyturso`. Cloud transports, remote sync, SQLite fallbacks,
+compatibility shims, and experimental engine features are excluded.
+
+## Navigation
+
+- [Architecture](docs/architecture.md)
+- [Backend contract](docs/design/backend-contract.md)
+- [Configuration](docs/configuration.md)
+- [Compatibility status](docs/compatibility.md)
+- [Test runner](docs/test-runner.md)
+- [Testing](docs/testing.md)
+- [Security and supply chain](docs/security.md)
+- [Post-v1 roadmap](docs/roadmap.md)
+- [Releasing](docs/releasing.md)
+- [Documentation index](docs/index.md)
+- [Agent operating guide](AGENTS.md)

django_pyturso-0.1.0/README.md

@@ -0,0 +1,60 @@
+# django-pyturso
+
+![django-pyturso banner](https://raw.githubusercontent.com/btfranklin/django-pyturso/main/.github/social%20preview/django_pyturso_social_preview.jpg "django-pyturso")
+
+`django-pyturso` is a Django database backend for the embedded Turso database
+engine exposed by `pyturso`. It will let a Django project use its ordinary ORM,
+migrations, forms, admin, and transaction APIs against a local Turso database
+file.
+
+This repository is deliberately scoped to embedded, local Turso. It does not
+provide Turso Cloud access, libSQL-over-HTTP support, replication, sync, or a
+project-specific compatibility layer.
+
+## Status
+
+The pre-release backend is implemented and covered by focused tests for ORM,
+migrations, transactions, Django integration, driver behavior, and package
+installation. Publication remains a separate, explicitly authorized action.
+
+The v1 contract intentionally excludes writing non-NULL Django `BinaryField`
+values because the stable `pyturso` 0.7 line does not expose the required PEP
+249 `Binary()` constructor. The backend deliberately does not patch or wrap the
+real `turso` module. See the compatibility document before evaluating the
+package.
+
+## Quickstart
+
+```bash
+pdm install --group dev
+pdm run check
+```
+
+Configure a Django database with no external service:
+
+```python
+DATABASES = {
+    "default": {
+        "ENGINE": "django_pyturso",
+        "NAME": BASE_DIR / "db.sqlite3",
+    }
+}
+```
+
+The package requires CPython 3.14 or later and targets Django 6 and embedded
+local Turso through `pyturso`. Cloud transports, remote sync, SQLite fallbacks,
+compatibility shims, and experimental engine features are excluded.
+
+## Navigation
+
+- [Architecture](docs/architecture.md)
+- [Backend contract](docs/design/backend-contract.md)
+- [Configuration](docs/configuration.md)
+- [Compatibility status](docs/compatibility.md)
+- [Test runner](docs/test-runner.md)
+- [Testing](docs/testing.md)
+- [Security and supply chain](docs/security.md)
+- [Post-v1 roadmap](docs/roadmap.md)
+- [Releasing](docs/releasing.md)
+- [Documentation index](docs/index.md)
+- [Agent operating guide](AGENTS.md)

django_pyturso-0.1.0/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,32 @@
+# Third-Party Notices
+
+Portions of this distribution are adapted from Django 6.0.7, commit
+`e2a424605ac2e7e6e799496542fb2997207e2f23`.
+
+Django is licensed under the BSD 3-Clause License:
+
+Copyright (c) Django Software Foundation and individual contributors.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice,
+   this list of conditions and the following disclaimer.
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+3. Neither the name of Django nor the names of its contributors may be used to
+   endorse or promote products derived from this software without specific
+   prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

django_pyturso-0.1.0/pyproject.toml

@@ -0,0 +1,108 @@
+[project]
+name = "django-pyturso"
+dynamic = []
+description = "A Django database backend for the embedded Turso database engine"
+readme = "README.md"
+requires-python = ">=3.14"
+license = "MIT"
+license-files = [
+    "LICENSE",
+    "THIRD_PARTY_NOTICES.md",
+]
+authors = [
+    { name = "B.T. Franklin" },
+]
+classifiers = [
+    "Development Status :: 2 - Pre-Alpha",
+    "Framework :: Django :: 6.0",
+    "Programming Language :: Python :: 3.14",
+    "Typing :: Typed",
+]
+dependencies = [
+    "Django>=6.0.7",
+    "pyturso>=0.7.0",
+]
+version = "0.1.0"
+
+[dependency-groups]
+dev = [
+    "pytest>=9.1.1",
+    "pytest-django>=4.12.0",
+    "ruff>=0.15.21",
+    "mypy>=2.3.0",
+    "django-stubs>=6.0.6",
+    "hypothesis>=6.156.6",
+    "pytest-timeout>=2.4.0",
+    "build>=1.5.1",
+    "psutil>=7.2.2",
+]
+
+[build-system]
+requires = [
+    "pdm-backend>=2.4.9",
+]
+build-backend = "pdm.backend"
+
+[tool.pdm.version]
+source = "scm"
+fallback_version = "0.0.0"
+
+[tool.pdm.scripts]
+lint = "ruff check ."
+typecheck = "mypy src tests"
+test = "pytest"
+test-fast = "pytest --maxfail=1 -m 'not integration and not stress'"
+test-differential = "pytest -m differential"
+test-integration = "pytest -m integration"
+test-stress = "pytest -m stress"
+build = "pdm build"
+package-test = "python scripts/verify_packages.py"
+verify-release = "python scripts/verify_packages.py"
+
+[tool.pdm.scripts.check]
+composite = [
+    "lint",
+    "typecheck",
+    "test-fast",
+]
+
+[tool.pytest.ini_options]
+testpaths = [
+    "tests",
+]
+pythonpath = [
+    ".",
+]
+DJANGO_SETTINGS_MODULE = "tests.settings.turso_memory"
+markers = [
+    "core: complete supported core-backend behavior",
+    "differential: SQLite and Turso scenario comparison",
+    "integration: cross-component and subprocess integration",
+    "stress: long-running and recovery evidence",
+]
+
+[tool.ruff]
+target-version = "py314"
+line-length = 100
+
+[tool.ruff.lint]
+select = [
+    "E",
+    "F",
+    "W",
+    "I",
+]
+
+[tool.mypy]
+python_version = "3.14"
+strict = true
+files = [
+    "src",
+    "tests",
+]
+plugins = [
+    "mypy_django_plugin.main",
+]
+
+[tool.django-stubs]
+django_settings_module = "tests.settings.turso_memory"

django_pyturso-0.1.0/src/django_pyturso/__init__.py

@@ -0,0 +1 @@
+"""Django database backend for embedded Turso."""