ahi-sql 0.2.0__py3-none-any.whl

ahi/sql/__init__.py

@@ -0,0 +1,5 @@
+"""Small, dependency-light SQL helpers."""
+
+from ahi.sql.identifiers import placeholders, quote_identifier
+
+__all__ = ["placeholders", "quote_identifier"]

ahi/sql/identifiers.py

@@ -0,0 +1,51 @@
+"""Helpers for building SQL fragments safely.
+
+These cover the two things people most often hand-roll (and get wrong):
+quoting an identifier, and generating the right number of bind placeholders.
+Both default to ANSI/PostgreSQL-style quoting, which also matches Redshift.
+"""
+
+from __future__ import annotations
+
+
+def quote_identifier(name: str, *, quote: str = '"') -> str:
+    """Safely quote a SQL identifier (table/column name).
+
+    Wraps ``name`` in ``quote`` characters and escapes any embedded quote by
+    doubling it, the ANSI rule. Use this for identifiers only — never for
+    values, which belong in bind parameters.
+
+    Args:
+        name: The identifier to quote. Must be non-empty.
+        quote: The quote character (``"`` for ANSI/Redshift, `` ` `` for MySQL).
+
+    Raises:
+        ValueError: If ``name`` is empty.
+    """
+    if not name:
+        raise ValueError("identifier must be non-empty")
+    escaped = name.replace(quote, quote * 2)
+    return f"{quote}{escaped}{quote}"
+
+
+def placeholders(count: int, *, style: str = "qmark") -> str:
+    """Return a comma-separated list of bind placeholders for an ``IN`` clause.
+
+    Args:
+        count: Number of placeholders (must be >= 1).
+        style: ``"qmark"`` -> ``?, ?, ?`` (Athena),
+            ``"named"`` -> ``:1, :2, :3`` (Redshift Data API),
+            ``"format"`` -> ``%s, %s, %s`` (psycopg).
+
+    Raises:
+        ValueError: If ``count`` < 1 or ``style`` is unknown.
+    """
+    if count < 1:
+        raise ValueError("count must be >= 1")
+    if style == "qmark":
+        return ", ".join(["?"] * count)
+    if style == "format":
+        return ", ".join(["%s"] * count)
+    if style == "named":
+        return ", ".join(f":{i}" for i in range(1, count + 1))
+    raise ValueError(f"unknown placeholder style: {style!r}")

ahi_sql-0.2.0.dist-info/METADATA

@@ -0,0 +1,30 @@
+Metadata-Version: 2.4
+Name: ahi-sql
+Version: 0.2.0
+Summary: Small, dependency-light SQL helpers for AHI (safe identifiers, placeholders).
+Project-URL: Homepage, https://github.com/adaptivehealthintelligence/ahi-python-packages
+Project-URL: Documentation, https://adaptivehealthintelligence.github.io/ahi-python-packages/
+Project-URL: Repository, https://github.com/adaptivehealthintelligence/ahi-python-packages
+Author: Adaptive Health Intelligence
+License: MIT
+Keywords: ahi,sql
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+
+# ahi-sql
+
+Small, dependency-light SQL helpers — the bits people otherwise hand-roll and
+get subtly wrong.
+
+```python
+from ahi.sql import quote_identifier, placeholders
+
+quote_identifier("user table")          # '"user table"'
+placeholders(3, style="qmark")          # '?, ?, ?'   (Athena)
+placeholders(3, style="named")          # ':1, :2, :3' (Redshift Data API)
+```
+
+> Quote **identifiers** with `quote_identifier`. Quote **values** by passing them
+> as bind parameters to your driver — never by string-formatting them in.
+
+Part of [ahi-python-packages](https://github.com/adaptivehealthintelligence/ahi-python-packages).

ahi_sql-0.2.0.dist-info/RECORD

@@ -0,0 +1,5 @@
+ahi/sql/__init__.py,sha256=SP0W9dq1lSwlEoaupdsDxfh8EtiaLktQssDY6ON662k,155
+ahi/sql/identifiers.py,sha256=T7EA7dYeR8aG6EqGi0w8irMPd6Qo60ZvggFvyjaemU0,1810
+ahi_sql-0.2.0.dist-info/METADATA,sha256=QyNaEa-bnf-zmeezpLpHrkDohY_yr5y-b2UkESajCmw,1174
+ahi_sql-0.2.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+ahi_sql-0.2.0.dist-info/RECORD,,

ahi_sql-0.2.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any