TypeDAL 3.15.5__py3-none-any.whl → 3.16.1__py3-none-any.whl

typedal/__about__.py

@@ -5,4 +5,4 @@ This file contains the Version info for this package.
 # SPDX-FileCopyrightText: 2023-present Robin van der Noord <robinvandernoord@gmail.com>
 #
 # SPDX-License-Identifier: MIT
-__version__ = "3.15.5"
+__version__ = "3.16.1"

typedal/core.py

@@ -2,6 +2,8 @@
 Core functionality of TypeDAL.
 """
 
+from __future__ import annotations
+
 import contextlib
 import csv
 import datetime as dt
@@ -826,6 +828,31 @@ P = typing.ParamSpec("P")
 R = typing.TypeVar("R")
 
 
+def reorder_fields(
+    table: pydal.objects.Table, fields: typing.Iterable[str | Field | TypedField], keep_others: bool = True
+) -> None:
+    """
+    Reorder fields of a pydal table.
+
+    Args:
+        table: The pydal table object (e.g., db.mytable).
+        fields: List of field names (str) or Field objects in desired order.
+        keep_others (bool):
+            - True (default): keep other fields at the end, in their original order.
+            - False: remove other fields (only keep what's specified).
+    """
+    # Normalize input to field names
+    desired = [f.name if isinstance(f, (TypedField, Field, pydal.objects.Field)) else str(f) for f in fields]
+
+    new_order = [f for f in desired if f in table._fields]
+
+    if keep_others:
+        # Start with desired fields, then append the rest
+        new_order.extend(f for f in table._fields if f not in desired)
+
+    table._fields = new_order
+
+
 class TableMeta(type):
     """
     This metaclass contains functionality on table classes, that doesn't exist on its instances.
@@ -1367,6 +1394,19 @@ class TableMeta(type):
         """
         return cls._hook_once(cls._after_delete, fn)
 
+    def reorder_fields(cls, *fields: str | Field | TypedField, keep_others: bool = True):
+        """
+        Reorder fields of a typedal table.
+
+        Args:
+            fields: List of field names (str) or Field objects in desired order.
+            keep_others (bool):
+                - True (default): keep other fields at the end, in their original order.
+                - False: remove other fields (only keep what's specified).
+        """
+
+        return reorder_fields(cls._table, fields, keep_others=keep_others)
+
 
 class TypedField(Expression, typing.Generic[T_Value]):  # pragma: no cover
     """

{typedal-3.15.5.dist-info → typedal-3.16.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: TypeDAL
-Version: 3.15.5
+Version: 3.16.1
 Summary: Typing support for PyDAL
 Project-URL: Documentation, https://typedal.readthedocs.io/
 Project-URL: Issues, https://github.com/trialandsuccess/TypeDAL/issues

{typedal-3.15.5.dist-info → typedal-3.16.1.dist-info}/RECORD

@@ -1,9 +1,9 @@
-typedal/__about__.py,sha256=GGSOGb_he-ttp2Fo05jyy0iXMc7WB7-ql3FV_lv8vEo,207
+typedal/__about__.py,sha256=ADriH-GrEDgOQPesTz-uD9weZZ6p1nbMhIXrBryzBiY,207
 typedal/__init__.py,sha256=Y6LT5UE3HrfWND_drJddYFbDjfnvqQER8MxZiEREFGw,366
 typedal/caching.py,sha256=6YUzUMpan56nSy3D-Jl0FS-8V4LbTnpRSoDJHj6yPYo,11782
 typedal/cli.py,sha256=SnWceLPDd-t90VPHAV9O3RR7JZtpVniT55TqtrRv3VM,19255
 typedal/config.py,sha256=0qy1zrTUdtmXPM9jHzFnSR1DJsqGJqcdG6pvhzKQHe0,11625
-typedal/core.py,sha256=LqJt271aYA7cE7voqCsg0GpB_REx8L4LeabM4ur3jOA,110753
+typedal/core.py,sha256=BfG1xma3WSA3aGwqg-Erhgl9hgICJXks2zvMzZeDfsc,112227
 typedal/fields.py,sha256=oOmTonXG-g4Lpj5_gSr8GJ-EZIEqO435Fm8-MS_cmoc,7356
 typedal/for_py4web.py,sha256=KIIu8XgnAfRQCJfZCra79k8SInOHiFuLDKUv3hzTJng,1908
 typedal/for_web2py.py,sha256=xn7zo6ImsmTkH6LacbjLQl2oqyBvP0zLqRxEJvMQk1w,1929
@@ -13,7 +13,7 @@ typedal/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 typedal/types.py,sha256=1FIgv1s0be0E8r5Wd9E1nvDvK4ETV8u2NlfI7_P6UUY,6752
 typedal/web2py_py4web_shared.py,sha256=UYmD0_aK1bSVBt_f3j59Mxq-zOmQNkYkb8sPDUibq68,1539
 typedal/serializers/as_json.py,sha256=3JZlFhPrdvZVFAmH7P5DUAz8-TIk-br0F1CjKG3PFDM,2246
-typedal-3.15.5.dist-info/METADATA,sha256=_ufdyTJf7FWKYF_6Qegbk3Levcy9Qkd0d6Rt5nsqdTE,10461
-typedal-3.15.5.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-typedal-3.15.5.dist-info/entry_points.txt,sha256=m1wqcc_10rHWPdlQ71zEkmJDADUAnZtn7Jac_6mbyUc,44
-typedal-3.15.5.dist-info/RECORD,,
+typedal-3.16.1.dist-info/METADATA,sha256=mECBBbFascau7PlAYVdiYOljN9SfI53RVwomBN3BQIw,10461
+typedal-3.16.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+typedal-3.16.1.dist-info/entry_points.txt,sha256=m1wqcc_10rHWPdlQ71zEkmJDADUAnZtn7Jac_6mbyUc,44
+typedal-3.16.1.dist-info/RECORD,,