atquery 2.11.15__tar.gz

atquery-2.11.15/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 alpine
+
+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.

atquery-2.11.15/PKG-INFO

@@ -0,0 +1,63 @@
+Metadata-Version: 2.4
+Name: atquery
+Version: 2.11.15
+Summary: A Python module for simplifying DBAPI usage with one-query-per-file SQL management.
+Keywords: sql,database,dbapi,mysql,sqlite,duckdb
+Author: alpine
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Database
+Requires-Dist: mysql-connector-python ; extra == 'all'
+Requires-Dist: duckdb ; extra == 'all'
+Requires-Dist: json5 ; extra == 'all'
+Requires-Dist: sqlglot ; extra == 'all'
+Requires-Dist: python-dotenv>=1.2.2 ; extra == 'all'
+Requires-Dist: sqlglot>=30.4.2 ; extra == 'diff'
+Requires-Dist: duckdb>=0.10.0 ; extra == 'duckdb'
+Requires-Dist: mysql-connector-python>=8.0,<10 ; extra == 'mysql'
+Requires-Dist: json5>=0.12.1 ; extra == 'testing'
+Requires-Python: >=3.10
+Provides-Extra: all
+Provides-Extra: diff
+Provides-Extra: duckdb
+Provides-Extra: mysql
+Provides-Extra: testing
+Description-Content-Type: text/markdown
+
+# ATQuery
+
+DBAPI用のSQLファイル実行ヘルパーです。
+
+## インストール
+
+```bash
+pip install atquery
+```
+
+## 使い方
+
+```python
+import atquery
+
+ds = atquery.create_datasource("sqlite:///:memory:")
+q = atquery.load(__file__, "sql/SELECT__users.sql")
+
+with ds.connect() as conn:
+    users = q.getall(conn, {"status": "active"})
+```
+
+## 要件
+
+- Python 3.10以上
+
+## ライセンス
+
+MIT

atquery-2.11.15/README.md

@@ -0,0 +1,29 @@
+# ATQuery
+
+DBAPI用のSQLファイル実行ヘルパーです。
+
+## インストール
+
+```bash
+pip install atquery
+```
+
+## 使い方
+
+```python
+import atquery
+
+ds = atquery.create_datasource("sqlite:///:memory:")
+q = atquery.load(__file__, "sql/SELECT__users.sql")
+
+with ds.connect() as conn:
+    users = q.getall(conn, {"status": "active"})
+```
+
+## 要件
+
+- Python 3.10以上
+
+## ライセンス
+
+MIT

atquery-2.11.15/pyproject.toml

@@ -0,0 +1,143 @@
+[build-system]
+requires = ["uv_build>=0.11.15,<0.12"]
+build-backend = "uv_build"
+
+[project]
+name = "atquery"
+version = "2.11.15"
+description = "A Python module for simplifying DBAPI usage with one-query-per-file SQL management."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+    { name = "alpine" },
+]
+keywords = ["sql", "database", "dbapi", "mysql", "sqlite", "duckdb"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Database",
+]
+
+[project.scripts]
+atquery = "atquery.cli.main:main"
+
+[project.optional-dependencies]
+mysql = [
+    "mysql-connector-python>=8.0,<10",
+]
+duckdb = [
+    "duckdb>=0.10.0",
+]
+testing = [
+    "json5>=0.12.1",
+]
+diff = [
+    "sqlglot>=30.4.2",
+]
+all = [
+    "mysql-connector-python",
+    "duckdb",
+    "json5",
+    "sqlglot",
+    "python-dotenv>=1.2.2",
+]
+
+[dependency-groups]
+dev = [
+    # -- optional dependencies --
+    "mysql-connector-python",
+    "duckdb",
+    "json5",
+    "python-dotenv",
+    "sqlglot",
+    # -- ruff --
+    "ruff",
+    # -- pyright --
+    "pyright",
+    #-- pytest --
+    "pytest>=7.0.0",
+    "pytest-cov>=4.0.0",
+    "pytest-mock>=3.10.0",
+    #-- dev-docs skill --
+    "pyyaml>=6.0.3",
+    "rich>=14.3.3",
+    "pytest-asyncio>=1.4.0",
+]
+
+
+[tool.uv]
+package = true
+
+[tool.ruff]
+# https://docs.astral.sh/ruff/configuration/
+src = ["src"]
+
+[tool.ruff.lint]
+# https://docs.astral.sh/ruff/rules/
+select = [
+    # pycodestyle (E, W)
+    "E2",
+    "E4",
+    "E7",
+    "E9",
+    "W",
+
+    # Pyflakes (F)
+    "F",
+
+    # flake8-no-pep420 (INP)
+    "INP",
+
+    # pep8-naming (N)
+    #"N",
+]
+
+[tool.ruff.lint.per-file-ignores]
+"docker/*.py" = ["INP"]
+"scripts/*.py" = ["INP"]
+"tests/*.py" = ["INP"]
+"var/*.py" = ["INP"]
+
+
+[tool.pyright]
+# https://microsoft.github.io/pyright/#/configuration
+include = ["src"]
+venvPath = "."
+venv = ".venv"
+typeCheckingMode = "basic"
+
+
+[tool.pytest.ini_options]
+cache_dir = "var/.pytest_cache"
+asyncio_mode = "auto"
+testpaths = ["tests"]
+
+
+[tool.coverage.run]
+source = ["src"]
+data_file = "var/.coverage"
+omit = [
+    "tests/*",
+]
+
+[tool.coverage.report]
+exclude_lines = [
+    "pragma: no cover",
+    "def __repr__",
+    "if self.debug:",
+    "if settings.DEBUG",
+    "raise AssertionError",
+    "raise NotImplementedError",
+    "if 0:",
+    "if __name__ == .__main__.:",
+    "class .*\\bProtocol\\):",
+    "@(abc\\.)?abstractmethod",
+]

atquery-2.11.15/src/atquery/__init__.py

@@ -0,0 +1,47 @@
+from .api_v2 import (
+    NULL,
+    ATConnection,
+    ATDataSource,
+    ATQuery,
+    ATResult,
+    ATRow,
+    ATRowCountError,
+    ATSQLError,
+    ATString,
+    ATWarning,
+    Resource,
+    create_async_datasource,
+    create_datasource,
+    escape4like,
+    execute,
+    execute_script,
+    export_csv,
+    insert_csv,
+    load,
+    sql,
+    upsert_csv,
+)
+
+__all__ = [
+    "NULL",
+    "ATConnection",
+    "ATDataSource",
+    "ATQuery",
+    "ATResult",
+    "ATRow",
+    "ATRowCountError",
+    "ATSQLError",
+    "ATString",
+    "ATWarning",
+    "Resource",
+    "create_async_datasource",
+    "create_datasource",
+    "escape4like",
+    "execute",
+    "execute_script",
+    "insert_csv",
+    "load",
+    "sql",
+    "upsert_csv",
+    "export_csv",
+]

atquery-2.11.15/src/atquery/aio/__init__.py

@@ -0,0 +1,101 @@
+"""atquery.aio - async 専用 DataSource / Query の公開 API
+
+Usage:
+    import atquery.aio
+
+    async_ds = atquery.aio.create_datasource("mysql://user:pass@host/db")
+    async_ds = atquery.aio.create_datasource("mysql://user:pass@host/db", pool_size=10)
+
+    async with async_ds.connect() as conn:
+        users = await at.aquery("SELECT__users.sql").getall(conn, {"status": "active"})
+"""
+import re
+from importlib import import_module
+from typing import Any
+from urllib.parse import parse_qsl, urlparse
+
+from atquery.aio.engine import (
+    ATAsyncConnection,
+    ATAsyncConnectionPool,
+    ATAsyncDataSource,
+    ATAsyncResult,
+)
+from atquery.aio.query import ATAsyncQuery, ATAsyncTypedQueryProxy
+
+_ASYNC_DATASOURCE_TYPES: dict[str, tuple[str, str]] = {
+    "mysql": ("atquery.dialect.mysql.aio", "ATMySQLAsyncDataSource"),
+    "mysql+mysqlconnector": ("atquery.dialect.mysql.aio", "ATMySQLAsyncDataSource"),
+    "mysql+mysqlconnector#poolable": ("atquery.dialect.mysql.aio", "ATMySQLAsyncPoolableDataSource"),
+    "mysql#poolable": ("atquery.dialect.mysql.aio", "ATMySQLAsyncPoolableDataSource"),
+}
+
+_USER = re.compile(r"^.+:\/\/([^:]+:[^@]+@)")
+
+
+def create_datasource(uri: str, pool_size: int = 0) -> ATAsyncDataSource:
+    """async 専用 DataSource を生成する。
+
+    Args:
+        uri: 接続URI。例: "mysql://user:pass@host/db"
+        pool_size: コネクションプールサイズ。0の場合はプールなし。
+
+    Returns:
+        ATAsyncDataSource: async専用DataSource
+    """
+    username = None
+    password = None
+    if match := _USER.match(uri):
+        user = match.group(1)
+        (username, password) = user.split(":", 1)
+        password = password[:-1]  # '@' を除く
+        uri = uri.replace(user, "", 1)
+
+    sr = urlparse(uri)
+    scheme = sr.scheme
+    params: dict[str, Any] = dict(parse_qsl(sr.query))
+
+    if pool_size:
+        scheme += "#poolable"
+        params["pool_size"] = pool_size
+
+    info = _ASYNC_DATASOURCE_TYPES.get(scheme)
+    if info is None:
+        raise ValueError(f'scheme "{scheme}" は async DataSource でサポートされていません。')
+
+    cls = getattr(import_module(info[0]), info[1])
+    return cls(
+        user=username or sr.username,
+        password=password or sr.password,
+        host=sr.hostname,
+        port=sr.port,
+        database=sr.path[1:],
+        **params,
+    )
+
+
+def load(py: str, filepath: str, use_cache: bool = True) -> ATAsyncQuery:
+    """SQLファイルを読み込んで ATAsyncQuery のインスタンスを生成する。
+
+    Args:
+        py: ファイル検索の起点モジュール（通常は __file__）
+        filepath: SQLファイルの相対パス
+        use_cache: キャッシュを使用するか
+
+    Returns:
+        ATAsyncQuery: インスタンス
+    """
+    from atquery.factory import Resource
+
+    return Resource.aload(py, filepath, use_cache=use_cache)
+
+
+__all__ = [
+    "ATAsyncConnection",
+    "ATAsyncConnectionPool",
+    "ATAsyncDataSource",
+    "ATAsyncResult",
+    "ATAsyncQuery",
+    "ATAsyncTypedQueryProxy",
+    "create_datasource",
+    "load",
+]