simple-module-db 0.0.31__tar.gz → 0.0.32__tar.gz

{simple_module_db-0.0.31 → simple_module_db-0.0.32}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: simple_module_db
-Version: 0.0.31
+Version: 0.0.32
 Summary: Per-module SQLModel Base, async session, standard mixins (Audit, SoftDelete, MultiTenant, Versioned) for simple_module
 Project-URL: Homepage, https://github.com/antosubash/simple_module_python
 Project-URL: Repository, https://github.com/antosubash/simple_module_python
@@ -25,7 +25,7 @@ Requires-Dist: aiosqlite>=0.20
 Requires-Dist: alembic>=1.14
 Requires-Dist: asyncpg>=0.30
 Requires-Dist: psycopg2-binary>=2.9
-Requires-Dist: simple-module-core==0.0.31
+Requires-Dist: simple-module-core==0.0.32
 Requires-Dist: sqlalchemy[asyncio]>=2.0
 Requires-Dist: sqlmodel>=0.0.22
 Description-Content-Type: text/markdown

{simple_module_db-0.0.31 → simple_module_db-0.0.32}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "simple_module_db"
-version = "0.0.31"
+version = "0.0.32"
 description = "Per-module SQLModel Base, async session, standard mixins (Audit, SoftDelete, MultiTenant, Versioned) for simple_module"
 readme = "README.md"
 license = "MIT"
@@ -28,7 +28,7 @@ dependencies = [
     # The async app code goes through asyncpg; migration env.py rewrites the
     # URL to +psycopg2 because Alembic's online migrations are sync-only.
     "psycopg2-binary>=2.9",
-    "simple_module_core==0.0.31",
+    "simple_module_core==0.0.32",
     "sqlalchemy[asyncio]>=2.0",
     "sqlmodel>=0.0.22",
 ]

{simple_module_db-0.0.31 → simple_module_db-0.0.32}/simple_module_db/__init__.py

@@ -12,10 +12,12 @@ from simple_module_db.migrations import (
 )
 from simple_module_db.mixins import AuditMixin, MultiTenantMixin, SoftDeleteMixin, VersionedMixin
 from simple_module_db.provider import DatabaseProvider, detect_provider
+from simple_module_db.search import LIKE_ESCAPE_CHAR, like_contains_pattern, like_prefix_pattern
 from simple_module_db.session import DatabaseState, init_db
 from simple_module_db.transaction import CommitBeforeResponseMiddleware, finalize_session
 
 __all__ = [
+    "LIKE_ESCAPE_CHAR",
     "AuditMixin",
     "AuditRecord",
     "CommitBeforeResponseMiddleware",
@@ -32,6 +34,8 @@ __all__ = [
     "finalize_session",
     "get_db",
     "init_db",
+    "like_contains_pattern",
+    "like_prefix_pattern",
     "make_include_object",
     "make_process_revision_directives",
     "render_item",

simple_module_db-0.0.32/simple_module_db/search.py

@@ -0,0 +1,32 @@
+"""Shared search-pattern helpers for LIKE/ILIKE filters."""
+
+from __future__ import annotations
+
+LIKE_ESCAPE_CHAR = "\\"
+
+
+def _escape_like_term(term: str) -> str:
+    return term.replace("\\", "\\\\").replace("%", "\\%").replace("_", "\\_")
+
+
+def like_contains_pattern(term: str) -> str:
+    """Contains-match LIKE pattern with metacharacters escaped, so a literal
+    ``%`` or ``_`` in a search term matches as text, not as a wildcard.
+
+    Pair with ``ilike(pattern, escape=LIKE_ESCAPE_CHAR)`` (or ``like(...)``)
+    so the escape character actually takes effect.
+    """
+    return f"%{_escape_like_term(term)}%"
+
+
+def like_prefix_pattern(term: str) -> str:
+    """Prefix-match LIKE pattern with metacharacters escaped, so a literal
+    ``%`` or ``_`` in the prefix matches as text, not as a wildcard.
+
+    Without this, a caller-supplied prefix containing ``%`` (e.g. a
+    ``content_type`` family filter built from a query param) widens the match
+    instead of narrowing it. Pair with ``ilike(pattern,
+    escape=LIKE_ESCAPE_CHAR)`` (or ``like(...)``) so the escape character
+    actually takes effect.
+    """
+    return f"{_escape_like_term(term)}%"