chore: resolve ruff warnings and add F401 fixes

- Add F401 fixes to __all__ in named_connections/__init__.py, mixins/__init__.py, protocols/__init__.py
- Fix unused imports in various files (from ruff --fix)
- Update extension examples to use 4-section format consistently

Author: vistart

src/rhosocial/activerecord/backend/impl/postgres/cli/connection.py

@@ -3,7 +3,6 @@
 
 import os
 
-from .output import RICH_AVAILABLE
 
 
 def add_connection_args(parser):

src/rhosocial/activerecord/backend/impl/postgres/cli/info.py

@@ -9,7 +9,6 @@
 import inspect
 import json
 import logging
-import sys
 from typing import Any, Dict, List, Optional, Tuple
 
 from rhosocial.activerecord.backend.dialect.protocols import (

src/rhosocial/activerecord/backend/impl/postgres/dialect.py

@@ -47,7 +47,6 @@
     ArraySupport,
     ExplainSupport,
     GraphSupport,
-    LockingSupport,
     MergeSupport,
     OrderedSetAggregationSupport,
     QualifyClauseSupport,
@@ -58,15 +57,12 @@
     JoinSupport,
     ViewSupport,
     SchemaSupport,
-    IndexSupport,
     SequenceSupport,
-    TableSupport,
     SetOperationSupport,
     TruncateSupport,
     ILIKESupport,
     IntrospectionSupport,
     TransactionControlSupport,
-    ConstraintSupport,
     SQLFunctionSupport,
 )
 from .mixins import (

src/rhosocial/activerecord/backend/impl/postgres/examples/extensions/citext.py

@@ -41,7 +41,6 @@
 # ============================================================
 from rhosocial.activerecord.backend.impl.postgres.expression import (
     PostgresCreateExtensionExpression,
-    PostgresDropExtensionExpression,
 )
 from rhosocial.activerecord.backend.expression import (
     CreateTableExpression,
@@ -74,7 +73,7 @@
         name="citext",
     )
     sql, params = create_ext.to_sql()
-    print(f"\n--- CREATE EXTENSION ---")
+    print("\n--- CREATE EXTENSION ---")
     print(f"SQL: {sql}")
     backend.execute(sql, params)
     # Re-detect extensions after creation
@@ -113,7 +112,7 @@
 )
 
 sql, params = create_expr.to_sql()
-print(f"\n--- CREATE TABLE ---")
+print("\n--- CREATE TABLE ---")
 print(f"SQL: {sql}")
 
 # Only execute if extension is available
@@ -133,7 +132,7 @@
         ),
     )
     sql, params = insert_expr.to_sql()
-    print(f"\n--- INSERT ---")
+    print("\n--- INSERT ---")
     print(f"SQL: {sql}")
     print(f"Params: {params}")
     backend.execute(sql, params)
@@ -151,7 +150,7 @@
         == Literal(dialect, "test@example.com"),
     )
     sql, params = query.to_sql()
-    print(f"\n--- SELECT (case-insensitive) ---")
+    print("\n--- SELECT (case-insensitive) ---")
     print(f"SQL: {sql}")
     print(f"Params: {params}")
 

src/rhosocial/activerecord/backend/impl/postgres/examples/extensions/cube.py

@@ -82,7 +82,7 @@
         name="cube",
     )
     sql, params = create_ext.to_sql()
-    print(f"\n--- CREATE EXTENSION ---")
+    print("\n--- CREATE EXTENSION ---")
     print(f"SQL: {sql}")
     backend.execute(sql, params)
     # Re-detect extensions after creation
@@ -122,7 +122,7 @@
         if_not_exists=True,
     )
     sql, params = create_expr.to_sql()
-    print(f"\n--- CREATE TABLE ---")
+    print("\n--- CREATE TABLE ---")
     print(f"SQL: {sql}")
     backend.execute(sql, params)
 
@@ -146,7 +146,7 @@
         ),
     )
     sql, params = insert_expr.to_sql()
-    print(f"\n--- INSERT cube data ---")
+    print("\n--- INSERT cube data ---")
     print(f"SQL: {sql}")
     print(f"Params: {params}")
     backend.execute(sql, params)
@@ -168,8 +168,8 @@
     )
     sql, params = query.to_sql()
     result = backend.execute(sql, params, options=opts)
-    print(f"\n--- Contains operator (@>) ---")
-    print(f"Points contained within range '(0.1,0.2,0.0),(0.5,0.6,0.3)':")
+    print("\n--- Contains operator (@>) ---")
+    print("Points contained within range '(0.1,0.2,0.0),(0.5,0.6,0.3)':")
     print(f"SQL: {sql}")
     print(f"Results: {result.data}")
 
@@ -187,8 +187,8 @@
     )
     sql, params = query.to_sql()
     result = backend.execute(sql, params, options=opts)
-    print(f"\n--- Contained by operator (<@) ---")
-    print(f"Points contained by the range cube:")
+    print("\n--- Contained by operator (<@) ---")
+    print("Points contained by the range cube:")
     print(f"SQL: {sql}")
     print(f"Results: {result.data}")
 
@@ -239,8 +239,8 @@
     )
     sql, params = query.to_sql()
     result = backend.execute(sql, params, options=opts)
-    print(f"\n--- Distance operator (<->) ---")
-    print(f"Products within distance 0.5 from point (0.5, 0.8, 0.2):")
+    print("\n--- Distance operator (<->) ---")
+    print("Products within distance 0.5 from point (0.5, 0.8, 0.2):")
     print(f"SQL: {sql}")
     print(f"Params: {params}")
     print(f"Results: {result.data}")
@@ -274,8 +274,8 @@
     )
     sql, params = query.to_sql()
     result = backend.execute(sql, params, options=opts)
-    print(f"\n--- Nearest neighbor search ---")
-    print(f"3 nearest to point (0.4, 0.5, 0.6):")
+    print("\n--- Nearest neighbor search ---")
+    print("3 nearest to point (0.4, 0.5, 0.6):")
     print(f"SQL: {sql}")
     print(f"Results: {result.data}")
 
@@ -289,7 +289,7 @@
         if_not_exists=True,
     )
     sql, params = create_idx.to_sql()
-    print(f"\n--- CREATE GIST INDEX ---")
+    print("\n--- CREATE GIST INDEX ---")
     print(f"SQL: {sql}")
     backend.execute(sql, params)
     print("GiST index created: idx_products_feature_vector")

src/rhosocial/activerecord/backend/impl/postgres/examples/extensions/earthdistance.py

@@ -82,7 +82,7 @@
         name="cube",
     )
     sql, params = create_ext.to_sql()
-    print(f"\n--- CREATE EXTENSION (cube) ---")
+    print("\n--- CREATE EXTENSION (cube) ---")
     print(f"SQL: {sql}")
     backend.execute(sql, params)
     backend.introspect_and_adapt()
@@ -94,7 +94,7 @@
         name="earthdistance",
     )
     sql, params = create_ext.to_sql()
-    print(f"\n--- CREATE EXTENSION (earthdistance) ---")
+    print("\n--- CREATE EXTENSION (earthdistance) ---")
     print(f"SQL: {sql}")
     backend.execute(sql, params)
     # Re-detect extensions after creation
@@ -144,7 +144,7 @@
         if_not_exists=True,
     )
     sql, params = create_expr.to_sql()
-    print(f"\n--- CREATE TABLE ---")
+    print("\n--- CREATE TABLE ---")
     print(f"SQL: {sql}")
     backend.execute(sql, params)
 
@@ -165,7 +165,7 @@
         ),
     )
     sql, params = insert_expr.to_sql()
-    print(f"\n--- INSERT coordinate data ---")
+    print("\n--- INSERT coordinate data ---")
     print(f"SQL: {sql}")
     print(f"Params: {params}")
     backend.execute(sql, params)
@@ -188,7 +188,7 @@
         select=[distance_func.as_("distance_meters")],
     )
     sql, params = query.to_sql()
-    print(f"\n--- Distance between New York and Los Angeles ---")
+    print("\n--- Distance between New York and Los Angeles ---")
     print(f"SQL: {sql}")
     result = backend.execute(sql, params, options=opts)
     print(f"Result: {result.data}")
@@ -238,7 +238,7 @@
         ),
     )
     sql, params = query.to_sql()
-    print(f"\n--- Cities within 500km of New York ---")
+    print("\n--- Cities within 500km of New York ---")
     print(f"SQL: {sql}")
     print(f"Params: {params}")
     result = backend.execute(sql, params, options=opts)
@@ -281,7 +281,7 @@
         ),
     )
     sql, params = query.to_sql()
-    print(f"\n--- Cities within 1500km of Chicago ---")
+    print("\n--- Cities within 1500km of Chicago ---")
     print(f"SQL: {sql}")
     print(f"Params: {params}")
     result = backend.execute(sql, params, options=opts)

src/rhosocial/activerecord/backend/impl/postgres/examples/extensions/fuzzystrmatch.py

@@ -61,7 +61,7 @@
         name="fuzzystrmatch",
     )
     sql, params = create_ext.to_sql()
-    print(f"\n--- CREATE EXTENSION ---")
+    print("\n--- CREATE EXTENSION ---")
     print(f"SQL: {sql}")
     backend.execute(sql, params)
     # Re-detect extensions after creation
@@ -85,7 +85,7 @@
         ],
     )
     sql, params = lev_query.to_sql()
-    print(f"\n--- Levenshtein distance ---")
+    print("\n--- Levenshtein distance ---")
     print(f"SQL: {sql}")
     print(f"Params: {params}")
     result = backend.execute(sql, params, options=opts)
@@ -126,7 +126,7 @@
         ],
     )
     sql, params = soundex_query.to_sql()
-    print(f"\n--- Soundex encoding ---")
+    print("\n--- Soundex encoding ---")
     print(f"SQL: {sql}")
     print(f"Params: {params}")
     result = backend.execute(sql, params, options=opts)
@@ -160,7 +160,7 @@
         ],
     )
     sql, params = diff_query.to_sql()
-    print(f"\n--- Difference (Soundex similarity) ---")
+    print("\n--- Difference (Soundex similarity) ---")
     print(f"SQL: {sql}")
     print(f"Params: {params}")
     result = backend.execute(sql, params, options=opts)
@@ -192,7 +192,7 @@
         ],
     )
     sql, params = meta_query.to_sql()
-    print(f"\n--- Metaphone encoding ---")
+    print("\n--- Metaphone encoding ---")
     print(f"SQL: {sql}")
     print(f"Params: {params}")
     result = backend.execute(sql, params, options=opts)
@@ -222,7 +222,7 @@
         ],
     )
     sql, params = dmeta_query.to_sql()
-    print(f"\n--- Double Metaphone encoding ---")
+    print("\n--- Double Metaphone encoding ---")
     print(f"SQL: {sql}")
     print(f"Params: {params}")
     result = backend.execute(sql, params, options=opts)
@@ -250,7 +250,7 @@
         ],
     )
     sql, params = dmeta_alt_query.to_sql()
-    print(f"\n--- Double Metaphone alternate codes ---")
+    print("\n--- Double Metaphone alternate codes ---")
     print(f"SQL: {sql}")
     print(f"Params: {params}")
     result = backend.execute(sql, params, options=opts)

src/rhosocial/activerecord/backend/impl/postgres/examples/extensions/hstore.py

@@ -81,7 +81,7 @@
         name="hstore",
     )
     sql, params = create_ext.to_sql()
-    print(f"\n--- CREATE EXTENSION ---")
+    print("\n--- CREATE EXTENSION ---")
     print(f"SQL: {sql}")
     backend.execute(sql, params)
     # Re-detect extensions after creation
@@ -145,7 +145,7 @@
         ),
     )
     sql, params = insert_expr.to_sql()
-    print(f"\n--- INSERT hstore data ---")
+    print("\n--- INSERT hstore data ---")
     print(f"SQL: {sql}")
     print(f"Params: {params}")
     backend.execute(sql, params)
@@ -167,7 +167,7 @@
         from_=TableExpression(dialect, "products"),
     )
     sql, params = query.to_sql()
-    print(f"\n--- Get value by key (-> operator) ---")
+    print("\n--- Get value by key (-> operator) ---")
     print(f"SQL: {sql}")
     print(f"Params: {params}")
     result = backend.execute(sql, params, options=opts)
@@ -186,7 +186,7 @@
         ),
     )
     sql, params = query.to_sql()
-    print(f"\n--- Key exists (? operator) ---")
+    print("\n--- Key exists (? operator) ---")
     print(f"SQL: {sql}")
     print(f"Params: {params}")
     result = backend.execute(sql, params, options=opts)
@@ -205,7 +205,7 @@
         ),
     )
     sql, params = query.to_sql()
-    print(f"\n--- Contains operator (@>) ---")
+    print("\n--- Contains operator (@>) ---")
     print(f"SQL: {sql}")
     result = backend.execute(sql, params, options=opts)
     print(f"Products with color=silver: {result.data}")
@@ -225,7 +225,7 @@
         from_=TableExpression(dialect, "products"),
     )
     sql, params = query.to_sql()
-    print(f"\n--- Concatenation operator (||) ---")
+    print("\n--- Concatenation operator (||) ---")
     print(f"SQL: {sql}")
     result = backend.execute(sql, params, options=opts)
     print(f"Results: {result.data}")
@@ -244,7 +244,7 @@
         from_=TableExpression(dialect, "products"),
     )
     sql, params = query.to_sql()
-    print(f"\n--- Get all keys (akeys function) ---")
+    print("\n--- Get all keys (akeys function) ---")
     print(f"SQL: {sql}")
     result = backend.execute(sql, params, options=opts)
     print(f"Results: {result.data}")
@@ -263,7 +263,7 @@
         from_=TableExpression(dialect, "products"),
     )
     sql, params = query.to_sql()
-    print(f"\n--- Get all values (avals function) ---")
+    print("\n--- Get all values (avals function) ---")
     print(f"SQL: {sql}")
     result = backend.execute(sql, params, options=opts)
     print(f"Results: {result.data}")
@@ -282,7 +282,7 @@
         from_=TableExpression(dialect, "products"),
     )
     sql, params = query.to_sql()
-    print(f"\n--- Get keys as set (skeys function) ---")
+    print("\n--- Get keys as set (skeys function) ---")
     print(f"SQL: {sql}")
     result = backend.execute(sql, params, options=opts)
     print(f"Results: {result.data}")
@@ -302,7 +302,7 @@
         from_=TableExpression(dialect, "products"),
     )
     sql, params = query.to_sql()
-    print(f"\n--- Delete key (delete function) ---")
+    print("\n--- Delete key (delete function) ---")
     print(f"SQL: {sql}")
     print(f"Params: {params}")
     result = backend.execute(sql, params, options=opts)
@@ -332,7 +332,7 @@
         ),
     )
     sql, params = update_expr.to_sql()
-    print(f"\n--- UPDATE with hstore concatenation ---")
+    print("\n--- UPDATE with hstore concatenation ---")
     print(f"SQL: {sql}")
     print(f"Params: {params}")
     result = backend.execute(sql, params, options=dml_opts)