python-datastore-sqlalchemy 0.0.2__py3-none-any.whl → 0.0.4__py3-none-any.whl

python_datastore_sqlalchemy-0.0.4.dist-info/METADATA

@@ -0,0 +1,98 @@
+Metadata-Version: 2.4
+Name: python-datastore-sqlalchemy
+Version: 0.0.4
+Summary: SQLAlchemy dialect for google cloud datastore
+Author-email: "HY Chang(splasky)" <hychang.1997.tw@gmail.com>
+License: MIT
+Project-URL: Documentation, https://github.com/splasky/python-datastore-sqlalchemy/wiki
+Project-URL: Source, https://github.com/splasky/python-datastore-sqlalchemy
+Project-URL: Tracker, https://github.com/splasky/python-datastore-sqlalchemy/issues
+Keywords: SQLAlchemy,GCP,Datastore
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Topic :: Database :: Front-Ends
+Classifier: Operating System :: POSIX :: Linux
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: sqlalchemy<3.0.0,>=1.4.16
+Requires-Dist: google-cloud-datastore>=2.21.0
+Requires-Dist: google-cloud-firestore>=2.21.0
+Requires-Dist: google-cloud-bigquery>=3.35.0
+Requires-Dist: google-auth>=2.40.0
+Requires-Dist: sqlglot>=28.0.0
+Requires-Dist: pandas>=2.0.0
+Requires-Dist: requests
+Dynamic: license-file
+
+SQLAlchemy dialect for Google Cloud Datastore in Firestore mode
+========================
+
+## Installation
+
+Install from PyPI:
+```bash
+pip install python-datastore-sqlalchemy
+```
+
+Install from a local checkout:
+```bash
+uv pip install -e .
+```
+
+Runtime dependencies are declared in `pyproject.toml`. `requirements.txt` is not used by this project.
+
+## Usage
+
+```python
+from sqlalchemy import create_engine, text
+
+engine = create_engine(
+    "datastore://my-project/?database=my-db",
+    credentials="path/to/credentials.json",
+)
+
+with engine.connect() as conn:
+    result = conn.execute(text("SELECT * FROM test_table"))
+    print(result.fetchall())
+```
+
+## Preview
+
+<img src="assets/pie.png">
+
+> [!WARNING]
+> Please note: Not all GQL and SQL syntax has been fully tested. Should you encounter any bugs, please post the relevant query and open an issue on GitHub.
+
+## How to contribute
+
+Feel free to open issues and pull requests on GitHub.
+
+## Development
+
+This project supports Python 3.11 and newer. It uses a uv-managed virtual environment by default. The lockfile is tracked so local development and CI use the same dependency resolution.
+
+Install the development environment:
+```bash
+uv sync --locked
+```
+
+Run the test suite:
+```bash
+uv run pytest
+```
+
+The Datastore-backed tests require the Google Cloud SDK with the `beta` and `cloud-datastore-emulator` components installed. If `gcloud` is not on `PATH`, point the test fixture at it explicitly:
+```bash
+GCLOUD_PATH=/path/to/google-cloud-sdk/bin/gcloud uv run pytest
+```
+
+## Development Notes
+
+- [Develop a SQLAlchemy and its dialects](https://hackmd.io/lsBW5GCVR82SORyWZ1cssA?view)

python_datastore_sqlalchemy-0.0.4.dist-info/RECORD

@@ -0,0 +1,12 @@
+python_datastore_sqlalchemy-0.0.4.dist-info/licenses/LICENSE,sha256=vcsHP9P3NtGefy7ojTRCgi3w0QqF_igVlmFP5A47YVA,1093
+sqlalchemy_datastore/__init__.py,sha256=8-KfLPXIwY4T4zjy9OvGRterN5imPk9om7MaWi5Nf_U,1239
+sqlalchemy_datastore/_helpers.py,sha256=bRvNeMz6QgJMW1M5K-dXksdnURYBZE-NIzt3tue92rg,4854
+sqlalchemy_datastore/_types.py,sha256=zs-Gr1XPP-UnppzsuWHEmD-wshkuosXM7yGeUIt-VVY,5092
+sqlalchemy_datastore/base.py,sha256=jvhe2WYFIRwtYpKlEaTaKH3R7Tf_hwXgA5s7zO8orL0,9560
+sqlalchemy_datastore/datastore_dbapi.py,sha256=xJVZR0Ymzj1XjB6-UeWQRHRLLYLzlOrjaYOEv3-13lY,94404
+sqlalchemy_datastore/parse_url.py,sha256=sTeNqBm-V4Dec97R4K264qvG05aUXG7iNFyKNCNkPJ8,10058
+python_datastore_sqlalchemy-0.0.4.dist-info/METADATA,sha256=OLfx47cI2pZzRbAyvUIPU5uV148TBA4ixHXurjgTRFM,3029
+python_datastore_sqlalchemy-0.0.4.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+python_datastore_sqlalchemy-0.0.4.dist-info/entry_points.txt,sha256=h54O-P7HFeCKpoeQ-XSSyP_GVZ1FRAY3gFCS5lkDBIs,77
+python_datastore_sqlalchemy-0.0.4.dist-info/top_level.txt,sha256=SE6uZfiwIQaJ1RDBfMm37dm7ZIZoqDcwQ1fDm32x0Rg,21
+python_datastore_sqlalchemy-0.0.4.dist-info/RECORD,,

{python_datastore_sqlalchemy-0.0.2.dist-info → python_datastore_sqlalchemy-0.0.4.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (82.0.0)
+Generator: setuptools (84.0.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

sqlalchemy_datastore/__init__.py

@@ -19,7 +19,7 @@
 
 from .base import CloudDatastoreDialect
 
-__version__ = "0.0.2"
+__version__ = "0.0.4"
 
 __all__ = [
     "__version__",

sqlalchemy_datastore/base.py

@@ -20,6 +20,7 @@ import logging
 from typing import Any, List, Optional
 
 from google.cloud import firestore_admin_v1
+from google.cloud.datastore.query import PropertyFilter
 from google.oauth2 import service_account
 from sqlalchemy import exc
 from sqlalchemy.engine import Connection, default
@@ -54,6 +55,7 @@ class CloudDatastoreDialect(default.DefaultDialect):
     supports_unicode_binds = True
     returns_unicode_strings = True
     description_encoding = None
+    supports_statement_cache = False
 
     # JSON support - required for SQLAlchemy JSON type
     _json_serializer = None
@@ -88,10 +90,15 @@ class CloudDatastoreDialect(default.DefaultDialect):
         self._client = None
 
     @classmethod
-    def dbapi(cls):
+    def import_dbapi(cls):
         """Return the DBAPI 2.0 driver."""
         return datastore_dbapi
 
+    @classmethod
+    def dbapi(cls):
+        """Return the DBAPI 2.0 driver."""
+        return cls.import_dbapi()
+
     def do_ping(self, dbapi_connection):
         """Performs a simple operation to check if the connection is still alive."""
         try:
@@ -212,7 +219,7 @@ class CloudDatastoreDialect(default.DefaultDialect):
         """Retrieve column information from the database."""
         client = self._client
         query = client.query(kind="__Stat_PropertyType_PropertyName_Kind__")
-        query.add_filter("kind_name", "=", table_name)
+        query.add_filter(filter=PropertyFilter("kind_name", "=", table_name))
         properties = list(query.fetch())
 
         return [

python_datastore_sqlalchemy-0.0.2.dist-info/METADATA

@@ -1,76 +0,0 @@
-Metadata-Version: 2.4
-Name: python-datastore-sqlalchemy
-Version: 0.0.2
-Summary: SQLAlchemy dialect for google cloud datastore
-Home-page: https://github.com/splasky/python-datastore-sqlalchemy
-Author: HY Chang(splasky)
-Author-email: hychang.1997.tw@gmail.com
-License: MIT
-Project-URL: Documentation, https://github.com/splasky/python-datastore-sqlalchemy/wiki
-Project-URL: Source, https://github.com/splasky/python-datastore-sqlalchemy
-Project-URL: Tracker, https://github.com/splasky/python-datastore-sqlalchemy/issues
-Keywords: SQLAlchemy GCP Datastore
-Classifier: Development Status :: 2 - Pre-Alpha
-Classifier: Intended Audience :: Developers
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: Implementation :: CPython
-Classifier: Topic :: Database :: Front-Ends
-Classifier: Operating System :: POSIX :: Linux
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: sqlalchemy<3.0.0,>=1.4.16
-Requires-Dist: google-cloud-datastore>=2.21.0
-Requires-Dist: google-cloud-firestore>=2.21.0
-Requires-Dist: google-cloud-bigquery>=3.35.0
-Requires-Dist: google-auth>=2.40.0
-Requires-Dist: sqlglot>=28.0.0
-Requires-Dist: pandas>=2.0.0
-Requires-Dist: requests
-Dynamic: author
-Dynamic: author-email
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: home-page
-Dynamic: keywords
-Dynamic: license
-Dynamic: license-file
-Dynamic: project-url
-Dynamic: requires-dist
-Dynamic: requires-python
-Dynamic: summary
-
-SQLAlchemy dialect for google cloud datastore(firestore mode)
-========================
-How to install
-```
-python3 setup.py install
-```
-or
-```
-pip install python-datastore-sqlalchemy
-```
-How to use
-```python
-from sqlalchemy import *
-from sqlalchemy.engine import create_engine
-from sqlalchemy.schema import *
-engine = create_engine("datastore://my-project/?database=my-db", credentials='path/to/credentials.json')
-conn = engine.connect()
-result = conn.execute("SELECT * fro" test_table")
-print(result.fetchall())
-```
-
-## Preview
-<img src="assets/pie.png">
-
-> [!WARNING]
-> Please note: Not all GQL and SQL syntax has been fully tested. Should you encounter any bugs, please post the relevant query and open an issue on GitHub.
-
-## How to contribute
-Feel free to open issues and pull requests on GitHub.
-
-## Development Notes
-- [Develop a SQLAlchemy and it's dialects](https://hackmd.io/lsBW5GCVR82SORyWZ1cssA?view)

python_datastore_sqlalchemy-0.0.2.dist-info/RECORD

@@ -1,12 +0,0 @@
-python_datastore_sqlalchemy-0.0.2.dist-info/licenses/LICENSE,sha256=vcsHP9P3NtGefy7ojTRCgi3w0QqF_igVlmFP5A47YVA,1093
-sqlalchemy_datastore/__init__.py,sha256=UmMpE_Sn41BU88qdX5KVvJPH7wMD2SufDBDQ-2cCwNQ,1239
-sqlalchemy_datastore/_helpers.py,sha256=bRvNeMz6QgJMW1M5K-dXksdnURYBZE-NIzt3tue92rg,4854
-sqlalchemy_datastore/_types.py,sha256=zs-Gr1XPP-UnppzsuWHEmD-wshkuosXM7yGeUIt-VVY,5092
-sqlalchemy_datastore/base.py,sha256=QpgQ19h9LA2h86TH14w4h_Ilg9_St76qrwD5r3Ln4bA,9322
-sqlalchemy_datastore/datastore_dbapi.py,sha256=xJVZR0Ymzj1XjB6-UeWQRHRLLYLzlOrjaYOEv3-13lY,94404
-sqlalchemy_datastore/parse_url.py,sha256=sTeNqBm-V4Dec97R4K264qvG05aUXG7iNFyKNCNkPJ8,10058
-python_datastore_sqlalchemy-0.0.2.dist-info/METADATA,sha256=zQgLqKvD-e8nqx-WLy2wGXhDjcOFiUD5ibrASBsXZbs,2471
-python_datastore_sqlalchemy-0.0.2.dist-info/WHEEL,sha256=YCfwYGOYMi5Jhw2fU4yNgwErybb2IX5PEwBKV4ZbdBo,91
-python_datastore_sqlalchemy-0.0.2.dist-info/entry_points.txt,sha256=h54O-P7HFeCKpoeQ-XSSyP_GVZ1FRAY3gFCS5lkDBIs,77
-python_datastore_sqlalchemy-0.0.2.dist-info/top_level.txt,sha256=SE6uZfiwIQaJ1RDBfMm37dm7ZIZoqDcwQ1fDm32x0Rg,21
-python_datastore_sqlalchemy-0.0.2.dist-info/RECORD,,