velocity-python 0.0.161__tar.gz → 0.0.163__tar.gz

{velocity_python-0.0.161 → velocity_python-0.0.163}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: velocity-python
-Version: 0.0.161
+Version: 0.0.163
 Summary: A rapid application development library for interfacing with data storage
 Author-email: Velocity Team <info@codeclubs.org>
 License-Expression: MIT

{velocity_python-0.0.161 → velocity_python-0.0.163}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "velocity-python"
-version = "0.0.161"
+version = "0.0.163"
 authors = [
   { name="Velocity Team", email="info@codeclubs.org" },
 ]

{velocity_python-0.0.161 → velocity_python-0.0.163}/src/velocity/__init__.py

@@ -1,4 +1,4 @@
-__version__ = version = "0.0.161"
+__version__ = version = "0.0.163"
 
 from . import aws
 from . import db

{velocity_python-0.0.161 → velocity_python-0.0.163}/src/velocity/db/core/table.py

@@ -34,10 +34,15 @@ SYSTEM_COLUMN_NAMES = (
     "sys_modified_count",
     "sys_dirty",
     "sys_table",
-    "description",
+    "sys_keywords",
 )
 
-_SYSTEM_COLUMN_SET = {name.lower() for name in SYSTEM_COLUMN_NAMES}
+# Legacy system columns retained for transitional compatibility checks.
+LEGACY_SYSTEM_COLUMN_NAMES = ("description",)
+
+_SYSTEM_COLUMN_SET = {
+    name.lower() for name in (*SYSTEM_COLUMN_NAMES, *LEGACY_SYSTEM_COLUMN_NAMES)
+}
 
 _NULLABLE_TRUE = {"YES", "TRUE", "T", "1", "Y"}
 _NULLABLE_FALSE = {"NO", "FALSE", "F", "0", "N"}
@@ -347,6 +352,16 @@ class Table:
         except Exception:
             columns = []
 
+        try:
+            index_rows = self.indexes()
+            existing_indexes = {
+                (row[0] or "").lower(): row[3]
+                for row in index_rows.as_tuple().all()
+                if row and len(row) >= 4
+            }
+        except Exception:
+            existing_indexes = {}
+
         sql_method = getattr(self.sql, "ensure_system_columns", None)
 
         if sql_method is None:
@@ -355,7 +370,10 @@ class Table:
             )
 
         result = sql_method(
-            self.name, existing_columns=columns, force=force
+            self.name,
+            existing_columns=columns,
+            existing_indexes=existing_indexes,
+            force=force,
         )
 
         if not result:
@@ -1294,7 +1312,11 @@ class Table:
         """
         Returns detailed information about all indexes on this table.
         """
-        sql, vals = self.sql.indexes(self.name)
+        sql_spec = self.sql.indexes(self.name)
+        if isinstance(sql_spec, tuple):
+            sql, vals = sql_spec
+        else:
+            sql, vals = sql_spec, tuple()
         if kwds.get("sql_only", False):
             return sql, vals
         return self.tx.execute(sql, vals, cursor=self.cursor())

{velocity_python-0.0.161 → velocity_python-0.0.163}/src/velocity/db/servers/mysql/sql.py

@@ -26,7 +26,7 @@ system_fields = [
     "sys_dirty",
     "sys_table",
     "sys_modified_count",
-    "description",
+    "sys_keywords",
 ]
 
 
@@ -396,7 +396,7 @@ CREATE TABLE {table_identifier} (
   `sys_modified_by` TEXT,
   `sys_modified_count` INT NOT NULL DEFAULT 0,
   `sys_dirty` TINYINT(1) NOT NULL DEFAULT 0,
-  `description` TEXT,
+    `sys_keywords` TEXT,
   PRIMARY KEY (`sys_id`)
 ) ENGINE=InnoDB;
 """.strip()
@@ -450,7 +450,13 @@ END;
         return "\n".join(statements), tuple()
 
     @classmethod
-    def ensure_system_columns(cls, name, existing_columns=None, force=False):
+    def ensure_system_columns(
+        cls,
+        name,
+        existing_columns=None,
+        force=False,
+        existing_indexes=None,
+    ):
         """Ensure MySQL tables maintain the Velocity system metadata."""
         existing_columns = {col.lower() for col in existing_columns or []}
 

{velocity_python-0.0.161 → velocity_python-0.0.163}/src/velocity/db/servers/postgres/sql.py

@@ -27,7 +27,7 @@ system_fields = [
     "sys_modified_count",
     "sys_dirty",
     "sys_table",
-    "description",
+    "sys_keywords",
 ]
 
 
@@ -836,6 +836,16 @@ class SQL(BaseSQLDialect):
               COST 100;
         """
 
+    @staticmethod
+    def _sys_keywords_index_name(schema_unquoted, table_unquoted):
+        base_index_name = f"idx_{schema_unquoted}_{table_unquoted}_sys_keywords_tsv"
+        base_index_name = re.sub(r"[^0-9a-zA-Z_]+", "_", base_index_name)
+        if len(base_index_name) > 60:
+            digest = hashlib.sha256(base_index_name.encode("utf-8")).hexdigest()
+            base_index_name = f"idx_{table_unquoted[:30]}_{digest[:8]}_sk"
+            base_index_name = re.sub(r"[^0-9a-zA-Z_]+", "_", base_index_name)
+        return base_index_name[:63]
+
     @classmethod
     def create_table(cls, name, columns={}, drop=False):
         if "." in name:
@@ -865,7 +875,7 @@ class SQL(BaseSQLDialect):
               sys_modified_count INTEGER NOT NULL DEFAULT 0,
               sys_dirty BOOLEAN NOT NULL DEFAULT FALSE,
               sys_table TEXT NOT NULL,
-              description TEXT
+              sys_keywords TEXT
             );
 
             SELECT SETVAL(PG_GET_SERIAL_SEQUENCE('{fqtn}', 'sys_id'),1000,TRUE);
@@ -889,16 +899,33 @@ class SQL(BaseSQLDialect):
                 f"ALTER TABLE {TableHelper.quote(fqtn)} ADD COLUMN {TableHelper.quote(key)} {TYPES.get_type(val)};"
             )
 
+        index_name = cls._sys_keywords_index_name(schema_unquoted, table_unquoted)
+        index_identifier = TableHelper.quote(index_name)
+        sql.append(
+            f"CREATE INDEX {index_identifier} ON {fqtn} USING GIN (TO_TSVECTOR('simple', COALESCE(sys_keywords, '')));"
+        )
+
         sql = sqlparse.format(" ".join(sql), reindent=True, keyword_case="upper")
         return sql, tuple()
 
     @classmethod
-    def ensure_system_columns(cls, name, existing_columns=None, force=False):
+    def ensure_system_columns(
+        cls,
+        name,
+        existing_columns=None,
+        force=False,
+        existing_indexes=None,
+    ):
         """Ensure all Velocity system columns and triggers exist for the table."""
         existing_columns = {
             col.lower() for col in (existing_columns or [])
         }
 
+        existing_indexes = {
+            (idx or "").lower(): (definition or "")
+            for idx, definition in (existing_indexes or {}).items()
+        }
+
         required_columns = [
             "sys_id",
             "sys_created",
@@ -908,7 +935,7 @@ class SQL(BaseSQLDialect):
             "sys_modified_count",
             "sys_dirty",
             "sys_table",
-            "description",
+            "sys_keywords",
         ]
 
         missing_columns = [
@@ -955,7 +982,7 @@ class SQL(BaseSQLDialect):
             "sys_modified_count": "INTEGER NOT NULL DEFAULT 0",
             "sys_dirty": "BOOLEAN NOT NULL DEFAULT FALSE",
             "sys_table": "TEXT",
-            "description": "TEXT",
+            "sys_keywords": "TEXT",
         }
 
         for column, definition in column_definitions.items():
@@ -1023,6 +1050,27 @@ class SQL(BaseSQLDialect):
             """
             )
 
+        if "sys_keywords" in columns_after:
+            index_name = cls._sys_keywords_index_name(schema_unquoted, table_unquoted)
+            quoted_index_name = TableHelper.quote(index_name)
+
+            current_definition = existing_indexes.get(index_name.lower(), "")
+            current_definition_lower = current_definition.lower()
+            has_target = (
+                "to_tsvector" in current_definition_lower
+                and "coalesce" in current_definition_lower
+                and "sys_keywords" in current_definition_lower
+            )
+            needs_rebuild = force or not has_target
+
+            if needs_rebuild:
+                statements.append(
+                    f"DROP INDEX IF EXISTS {quoted_index_name};"
+                )
+                statements.append(
+                    f"CREATE INDEX {quoted_index_name} ON {fqtn} USING GIN (TO_TSVECTOR('simple', COALESCE(sys_keywords, '')));"
+                )
+
         if not statements:
             return None
 
@@ -1508,6 +1556,19 @@ class SQL(BaseSQLDialect):
         """
         Returns SQL for retrieving all indexes on a given table with detailed attributes.
         """
+        if "." in table:
+            schema, tbl = table.split(".", 1)
+            schema = schema.replace('"', "")
+            tbl = tbl.replace('"', "")
+            return (
+                """
+                SELECT indexname, tablename, schemaname, indexdef
+                FROM pg_indexes
+                WHERE tablename = %s AND schemaname = %s
+                """,
+                (tbl, schema),
+            )
+
         return (
             """
             SELECT indexname, tablename, schemaname, indexdef

{velocity_python-0.0.161 → velocity_python-0.0.163}/src/velocity/db/servers/sqlite/sql.py

@@ -26,7 +26,7 @@ system_fields = [
     "sys_dirty",
     "sys_table",
     "sys_modified_count",
-    "description",
+    "sys_keywords",
 ]
 
 
@@ -379,7 +379,7 @@ CREATE TABLE {table_identifier} (
   "sys_modified_by" TEXT,
   "sys_modified_count" INTEGER NOT NULL DEFAULT 0,
   "sys_dirty" INTEGER NOT NULL DEFAULT 0,
-  "description" TEXT
+                            "sys_keywords" TEXT
 );
 """.strip()
         )
@@ -431,7 +431,13 @@ END;
         return "\n".join(statements), tuple()
 
     @classmethod
-    def ensure_system_columns(cls, name, existing_columns=None, force=False):
+    def ensure_system_columns(
+        cls,
+        name,
+        existing_columns=None,
+        force=False,
+        existing_indexes=None,
+    ):
         """Ensure SQLite tables maintain the Velocity system triggers/columns."""
         existing_columns = {col.lower() for col in existing_columns or []}
 

{velocity_python-0.0.161 → velocity_python-0.0.163}/src/velocity/db/servers/sqlserver/sql.py

@@ -26,7 +26,7 @@ system_fields = [
     "sys_dirty",
     "sys_table",
     "sys_modified_count",
-    "description",
+    "sys_keywords",
 ]
 
 
@@ -426,7 +426,7 @@ CREATE TABLE {table_identifier} (
   [sys_modified_by] NVARCHAR(255),
   [sys_modified_count] INT NOT NULL DEFAULT 0,
   [sys_dirty] BIT NOT NULL DEFAULT 0,
-  [description] NVARCHAR(MAX)
+    [sys_keywords] NVARCHAR(MAX)
 );
 """.strip()
         )
@@ -485,7 +485,13 @@ END;
         return "\n".join(statements), tuple()
 
     @classmethod
-    def ensure_system_columns(cls, name, existing_columns=None, force=False):
+    def ensure_system_columns(
+        cls,
+        name,
+        existing_columns=None,
+        force=False,
+        existing_indexes=None,
+    ):
         """Ensure SQL Server tables maintain Velocity system metadata."""
         existing_columns = {col.lower() for col in existing_columns or []}
 

{velocity_python-0.0.161 → velocity_python-0.0.163}/src/velocity_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: velocity-python
-Version: 0.0.161
+Version: 0.0.163
 Summary: A rapid application development library for interfacing with data storage
 Author-email: Velocity Team <info@codeclubs.org>
 License-Expression: MIT