velocity-python 0.0.115__py3-none-any.whl → 0.0.117__py3-none-any.whl

velocity/db/utils.py

@@ -11,109 +11,117 @@ from typing import Any, Callable, List, Optional, Union
 def safe_sort_key_none_last(field_name: str) -> Callable[[dict], tuple]:
     """
     Create a sort key function that places None values at the end.
-    
+
     Args:
         field_name: Name of the field to sort by
-        
+
     Returns:
         A function suitable for use as a sort key that handles None values
-        
+
     Example:
         rows = [{"date": "2024-01"}, {"date": None}, {"date": "2023-12"}]
         sorted_rows = sorted(rows, key=safe_sort_key_none_last("date"))
         # Result: [{"date": "2023-12"}, {"date": "2024-01"}, {"date": None}]
     """
+
     def sort_key(row: dict) -> tuple:
         value = row.get(field_name)
         if value is None:
             return (1, "")  # None values sort last
         return (0, value)
-    
+
     return sort_key
 
 
 def safe_sort_key_none_first(field_name: str) -> Callable[[dict], tuple]:
     """
     Create a sort key function that places None values at the beginning.
-    
+
     Args:
         field_name: Name of the field to sort by
-        
+
     Returns:
         A function suitable for use as a sort key that handles None values
-        
+
     Example:
         rows = [{"date": "2024-01"}, {"date": None}, {"date": "2023-12"}]
         sorted_rows = sorted(rows, key=safe_sort_key_none_first("date"))
         # Result: [{"date": None}, {"date": "2023-12"}, {"date": "2024-01"}]
     """
+
     def sort_key(row: dict) -> tuple:
         value = row.get(field_name)
         if value is None:
             return (0, "")  # None values sort first
         return (1, value)
-    
+
     return sort_key
 
 
-def safe_sort_key_with_default(field_name: str, default_value: Any = "") -> Callable[[dict], Any]:
+def safe_sort_key_with_default(
+    field_name: str, default_value: Any = ""
+) -> Callable[[dict], Any]:
     """
     Create a sort key function that replaces None values with a default.
-    
+
     Args:
         field_name: Name of the field to sort by
         default_value: Value to use for None entries
-        
+
     Returns:
         A function suitable for use as a sort key that handles None values
-        
+
     Example:
         rows = [{"date": "2024-01"}, {"date": None}, {"date": "2023-12"}]
         sorted_rows = sorted(rows, key=safe_sort_key_with_default("date", "1900-01"))
         # Result: [{"date": None}, {"date": "2023-12"}, {"date": "2024-01"}]
     """
+
     def sort_key(row: dict) -> Any:
         value = row.get(field_name)
         return default_value if value is None else value
-    
+
     return sort_key
 
 
-def safe_sort_rows(rows: List[dict], field_name: str, 
-                   none_handling: str = "last", 
-                   default_value: Any = "",
-                   reverse: bool = False) -> List[dict]:
+def safe_sort_rows(
+    rows: List[dict],
+    field_name: str,
+    none_handling: str = "last",
+    default_value: Any = "",
+    reverse: bool = False,
+) -> List[dict]:
     """
     Safely sort a list of dictionaries by a field that may contain None values.
-    
+
     Args:
         rows: List of dictionaries to sort
         field_name: Name of the field to sort by
         none_handling: How to handle None values - "first", "last", or "default"
         default_value: Default value to use when none_handling is "default"
         reverse: Whether to reverse the sort order
-        
+
     Returns:
         New list of dictionaries sorted by the specified field
-        
+
     Raises:
         ValueError: If none_handling is not a valid option
-        
+
     Example:
         rows = [
             {"name": "Alice", "date": "2024-01"},
             {"name": "Bob", "date": None},
             {"name": "Charlie", "date": "2023-12"}
         ]
-        
+
         # None values last
         sorted_rows = safe_sort_rows(rows, "date")
-        
-        # None values first  
+
+        # None values first
         sorted_rows = safe_sort_rows(rows, "date", none_handling="first")
-        
+
         # Replace None with default
-        sorted_rows = safe_sort_rows(rows, "date", none_handling="default", 
+        sorted_rows = safe_sort_rows(rows, "date", none_handling="default",
                                    default_value="1900-01")
     """
     if none_handling == "last":
@@ -123,37 +131,39 @@ def safe_sort_rows(rows: List[dict], field_name: str,
     elif none_handling == "default":
         key_func = safe_sort_key_with_default(field_name, default_value)
     else:
-        raise ValueError(f"Invalid none_handling option: {none_handling}. "
-                        "Must be 'first', 'last', or 'default'")
-    
+        raise ValueError(
+            f"Invalid none_handling option: {none_handling}. "
+            "Must be 'first', 'last', or 'default'"
+        )
+
     return sorted(rows, key=key_func, reverse=reverse)
 
 
 def group_by_fields(rows: List[dict], *field_names: str) -> dict:
     """
     Group rows by one or more field values.
-    
+
     Args:
         rows: List of dictionaries to group
         *field_names: Names of fields to group by
-        
+
     Returns:
         Dictionary where keys are tuples of field values and values are lists of rows
-        
+
     Example:
         rows = [
             {"email": "alice@example.com", "type": "premium", "amount": 100},
             {"email": "alice@example.com", "type": "basic", "amount": 50},
             {"email": "bob@example.com", "type": "premium", "amount": 100},
         ]
-        
+
         # Group by email only
         groups = group_by_fields(rows, "email")
         # Result: {
         #     ("alice@example.com",): [row1, row2],
         #     ("bob@example.com",): [row3]
         # }
-        
+
         # Group by email and type
         groups = group_by_fields(rows, "email", "type")
         # Result: {
@@ -168,34 +178,37 @@ def group_by_fields(rows: List[dict], *field_names: str) -> dict:
         if key not in groups:
             groups[key] = []
         groups[key].append(row)
-    
+
     return groups
 
 
-def safe_sort_grouped_rows(grouped_rows: dict, field_name: str,
-                          none_handling: str = "last",
-                          default_value: Any = "",
-                          reverse: bool = False) -> dict:
+def safe_sort_grouped_rows(
+    grouped_rows: dict,
+    field_name: str,
+    none_handling: str = "last",
+    default_value: Any = "",
+    reverse: bool = False,
+) -> dict:
     """
     Safely sort rows within each group of a grouped result.
-    
+
     Args:
         grouped_rows: Dictionary of grouped rows (from group_by_fields)
         field_name: Name of the field to sort by within each group
         none_handling: How to handle None values - "first", "last", or "default"
         default_value: Default value to use when none_handling is "default"
         reverse: Whether to reverse the sort order
-        
+
     Returns:
         Dictionary with the same keys but sorted lists as values
-        
+
     Example:
         # After grouping payment profiles by email and card number
         groups = group_by_fields(payment_profiles, "email_address", "card_number")
-        
+
         # Sort each group by expiration date, with None values last
         sorted_groups = safe_sort_grouped_rows(groups, "expiration_date")
-        
+
         # Now process each sorted group
         for group_key, sorted_group in sorted_groups.items():
             for idx, row in enumerate(sorted_group):
@@ -204,6 +217,8 @@ def safe_sort_grouped_rows(grouped_rows: dict, field_name: str,
     """
     result = {}
     for key, rows in grouped_rows.items():
-        result[key] = safe_sort_rows(rows, field_name, none_handling, default_value, reverse)
-    
+        result[key] = safe_sort_rows(
+            rows, field_name, none_handling, default_value, reverse
+        )
+
     return result

{velocity_python-0.0.115.dist-info → velocity_python-0.0.117.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: velocity-python
-Version: 0.0.115
+Version: 0.0.117
 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.115.dist-info → velocity_python-0.0.117.dist-info}/RECORD

@@ -1,29 +1,31 @@
-velocity/__init__.py,sha256=89oRDLFlR3tlSTcYrvhfokSBF3tLPmP4nt_p9ayIScY,107
+velocity/__init__.py,sha256=vYepl_-j4oCRAfwn61jSaTKIXufh522rvwO4XYqn_es,107
 velocity/app/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 velocity/app/invoices.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 velocity/app/orders.py,sha256=W-HAXEwY8-IFXbKh82HnMeRVZM7P-TWGEQOWtkLIzI4,6298
 velocity/app/payments.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 velocity/app/purchase_orders.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 velocity/aws/__init__.py,sha256=tj9-NliYxRVPYLnnDuA4FMwBHbbH4ed8gtHgwRskNgY,647
-velocity/aws/amplify.py,sha256=n6ttzHmbF8tc0ZDN8LIA6s_fnkZ3ylu3AAUAYyD9MzE,15048
+velocity/aws/amplify.py,sha256=ygu_QrZUMahOYIJfnri-AW-2r-3Xpn6zJr8vyTtSz9w,15284
 velocity/aws/handlers/__init__.py,sha256=xnpFZJVlC2uoeeFW4zuPST8wA8ajaQDky5Y6iXZzi3A,172
-velocity/aws/handlers/context.py,sha256=saeK-2hpfbuOZvA76C1_2ZJSblPO_tDuKeaeDVfli1w,8052
-velocity/aws/handlers/lambda_handler.py,sha256=k8ZTj4vhuDbB9xinQ1-s7hKgx5JznldTNT3-udfMw04,6391
+velocity/aws/handlers/base_handler.py,sha256=rnEX5X4a5P-FO9Va0-9ZJYCqfqtjvuf101UTz1Vfqyg,7822
+velocity/aws/handlers/context.py,sha256=Mf6Cnu4_dmYB870l51cVI9Mkd3IoE2-WdSty2qCwC0E,8354
+velocity/aws/handlers/exceptions.py,sha256=i4wcB8ZSWUHglX2xnesDlWLsU9AMYU72cHCWRBDmjQ8,361
+velocity/aws/handlers/lambda_handler.py,sha256=fKbTOYpN_scXFGGWMhB8tlsPYVGiX9RZyuq5rXQsOhU,4060
 velocity/aws/handlers/response.py,sha256=LXhtizLKnVBWjtHyE0h0bk-NYDrRpj7CHa7tRz9KkC4,9324
-velocity/aws/handlers/sqs_handler.py,sha256=nqt8NMOc5yO-L6CZo7NjgR8Q4KPKTDFBO-0eHu6oxkY,7149
-velocity/db/__init__.py,sha256=t7YJT42U19Vkd4MMz5MhU8IFryKfblNPLJcPqzpb4HQ,566
-velocity/db/exceptions.py,sha256=oTXzdxP0GrraGrqRD1JgIVP5urO5yNN7A3IzTiAtNJ0,2173
-velocity/db/utils.py,sha256=3uUTLjMUC6g18bn7jRGBajYlXNFlBDZkGxIwQSBK_Y8,7298
+velocity/aws/handlers/sqs_handler.py,sha256=rVOuLrrays1dO69S0snYnK9ImXYQ35l8ZzJTeXcEOfc,3269
+velocity/db/__init__.py,sha256=buxlhBZNQd2UjryPXJGiAzcgcIoBCucEXXhWJF1cMYI,567
+velocity/db/exceptions.py,sha256=XHREJvzNctrtYE-ScBRLnbk7thxTswkfWojKhMmBmd8,2185
+velocity/db/utils.py,sha256=JUGr7G-kRk4LPjDkZrmI8DHPHw9lZHukBVZNjCGMWZ4,7037
 velocity/db/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 velocity/db/core/column.py,sha256=tAr8tL3a2nyaYpNHhGl508FrY_pGZTzyYgjAV5CEBv4,4092
 velocity/db/core/database.py,sha256=3zNGItklu9tZCKsbx2T2vCcU1so8AL9PPL0DLjvaz6s,3554
 velocity/db/core/decorators.py,sha256=76Jkr9XptXt8cvcgp1zbHfuL8uHzWy8lwfR29u-DVu4,4574
-velocity/db/core/engine.py,sha256=Yy6uwxT44a4oEHrFF312ChzFO01cR2W79BTryFgTe-s,18635
-velocity/db/core/exceptions.py,sha256=tuDniRqTX8Opc2d033LPJOI3Ux4NSwUcHqW729n-HXA,1027
-velocity/db/core/result.py,sha256=dgiOXH-iJXuDH4PbSTWVkn-heAkJQcXCC-gs0ZuqF94,12814
-velocity/db/core/row.py,sha256=zZ3zZbWjZkZfYAYuZJLHFJ8jdXc7dYv8Iyv9Ut8W8tE,7261
+velocity/db/core/engine.py,sha256=cgiDWSAiMlkuJqzWtw7GaxejvSMtxlerRFb78aKS2ek,18491
+velocity/db/core/exceptions.py,sha256=9jhPtxagHZtGdMcSwa2uRe82Gqydla5fWCqs4v-Ah8U,1030
+velocity/db/core/result.py,sha256=FvI7dtXM-8vFeN5DWu0oc4O_smGJBqRvQ1V6SsEPog8,12844
+velocity/db/core/row.py,sha256=yqxm03uEDy3oSbnkCtKyiqFdSqG3zXTq2HIHYKOvPY4,7291
 velocity/db/core/sequence.py,sha256=VMBc0ZjGnOaWTwKW6xMNTdP8rZ2umQ8ml4fHTTwuGq4,3904
-velocity/db/core/table.py,sha256=oQFam6DwLnGiqa6v8Wys_yD_N4iWwfxGBwgLB5VUQSQ,34682
+velocity/db/core/table.py,sha256=yyv7Glds194Zp-ooA_iaqcmrVpWyoVFni1bLegLDays,34685
 velocity/db/core/transaction.py,sha256=unjmVkkfb7D8Wow6V8V8aLaxUZo316i--ksZxc4-I1Q,6613
 velocity/db/servers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 velocity/db/servers/mysql.py,sha256=qHwlB_Mg02R7QFjD5QvJCorYYiP50CqEiQyZVl3uYns,20914
@@ -32,11 +34,11 @@ velocity/db/servers/sqlite.py,sha256=X210a5pENT9PiVK7f16fxXzFwEsq8fSe58Vouv2xqlk
 velocity/db/servers/sqlite_reserved.py,sha256=-xmjl-Hgu6lKqkCAXq_6U8_aJX6gvaMgLMLdCt-Ej7o,3006
 velocity/db/servers/sqlserver.py,sha256=0uGLEWRXiUhrOVTpEA1zvaKq1mcfiaCDp9r7gX-N71g,29914
 velocity/db/servers/sqlserver_reserved.py,sha256=3LGQYU0qfvk6AbKety96gbzzfLbZ0dNHDPLxKGvvi4Q,4596
-velocity/db/servers/tablehelper.py,sha256=qOHHKgQgUC0t_AUcY5oaPfjkRJS9wnMI4YJCDIb9Rew,22583
-velocity/db/servers/postgres/__init__.py,sha256=FUvXO3R5CtKCTGRim1geisIxXbiG_aQ_VFSQX9HGsjw,529
+velocity/db/servers/tablehelper.py,sha256=Q48ObN5KD_U2sBP0GUcjaQjKeE4Hr351sPQirwQ0_1s,22163
+velocity/db/servers/postgres/__init__.py,sha256=saeE5iySVYMHCwlKMsHFYdPJmuLy33I9BpPUE0czUas,457
 velocity/db/servers/postgres/operators.py,sha256=A2T1qFwhzPl0fdXVhLZJhh5Qfx-qF8oZsDnxnq2n_V8,389
 velocity/db/servers/postgres/reserved.py,sha256=5tKLaqFV-HrWRj-nsrxl5KGbmeM3ukn_bPZK36XEu8M,3648
-velocity/db/servers/postgres/sql.py,sha256=vcdzj5PtlF3Qnt4Lh3y2OtaSuq4iLIUKyGP5F9vULE8,41576
+velocity/db/servers/postgres/sql.py,sha256=okWDm8Bj_vzSLTAIFQS5rHuIZz4WvAGNSHMZQtL5inI,41781
 velocity/db/servers/postgres/types.py,sha256=Wa45ppVf_pdWul-jYWFRGMl6IdSq8dAp10SKnhL7osQ,3757
 velocity/misc/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 velocity/misc/db.py,sha256=MPgt-kkukKR_Wh_S_5W-MyDgaeoZ4YLoDJ54wU2ppm4,2830
@@ -49,8 +51,8 @@ velocity/misc/tools.py,sha256=_bGneHHA_BV-kUonzw5H3hdJ5AOJRCKfzhgpkFbGqIo,1502
 velocity/misc/conv/__init__.py,sha256=MLYF58QHjzfDSxb1rdnmLnuEQCa3gnhzzZ30CwZVvQo,40
 velocity/misc/conv/iconv.py,sha256=d4_BucW8HTIkGNurJ7GWrtuptqUf-9t79ObzjJ5N76U,10603
 velocity/misc/conv/oconv.py,sha256=h5Lo05DqOQnxoD3y6Px_MQP_V-pBbWf8Hkgkb9Xp1jk,6032
-velocity_python-0.0.115.dist-info/licenses/LICENSE,sha256=aoN245GG8s9oRUU89KNiGTU4_4OtnNmVi4hQeChg6rM,1076
-velocity_python-0.0.115.dist-info/METADATA,sha256=mH47xoUtbkjBSArI6QU7Mtx9qLjyPguYdAcVbPwtSLw,34262
-velocity_python-0.0.115.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-velocity_python-0.0.115.dist-info/top_level.txt,sha256=JW2vJPmodgdgSz7H6yoZvnxF8S3fTMIv-YJWCT1sNW0,9
-velocity_python-0.0.115.dist-info/RECORD,,
+velocity_python-0.0.117.dist-info/licenses/LICENSE,sha256=aoN245GG8s9oRUU89KNiGTU4_4OtnNmVi4hQeChg6rM,1076
+velocity_python-0.0.117.dist-info/METADATA,sha256=YYvat0naHNdq7pBtNCBxBJ7SBKdhsFy0rOIbhKj4RNY,34262
+velocity_python-0.0.117.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+velocity_python-0.0.117.dist-info/top_level.txt,sha256=JW2vJPmodgdgSz7H6yoZvnxF8S3fTMIv-YJWCT1sNW0,9
+velocity_python-0.0.117.dist-info/RECORD,,