plexus-python-pulse-common 1.1.80__py3-none-any.whl → 1.1.81__py3-none-any.whl

plexus/pulse/common/utils/tagutils.py

@@ -444,6 +444,11 @@ def make_tag_target_model_mixin() -> type[pdt.BaseModel]:
             default=None,
             description="Additional properties of the tag target in JSON format",
         )
+        flags: int = Field(
+            sa_column=sa.Column(sa_sqlite.INTEGER),
+            default=0,
+            description="Integer bitmask storing status or metadata flags for this tag target",
+        )
 
         @pdt.field_validator("identifier", mode="after")
         @classmethod
@@ -619,6 +624,7 @@ if typing.TYPE_CHECKING:
         begin_dt: sa_orm.Mapped[datetime.datetime] = ...
         end_dt: sa_orm.Mapped[datetime.datetime] = ...
         props: sa_orm.Mapped[JsonType | None] = ...
+        flags: sa_orm.Mapped[int] = ...
 
 
     class TagTargetTable(TagTarget, SequenceModelMixinProtocol):
@@ -769,6 +775,7 @@ class TagCache(object):
         begin_dt: datetime.datetime | None = None,
         end_dt: datetime.datetime | None = None,
         props: JsonType | None = None,
+        flags: int | None = None,
     ) -> Chainable[Self, TagTargetTable]:
         """
         Updates a tag target.
@@ -781,6 +788,7 @@ class TagCache(object):
         :param begin_dt: New start datetime for the tag target's validity period.
         :param end_dt: New end datetime for the tag target's validity period.
         :param props: New additional tag target properties.
+        :param flags: New integer bitmask for status or metadata flags.
         :return: Chainable self and the updated ``TagTargetTable`` instance.
         """
 
@@ -808,6 +816,8 @@ class TagCache(object):
                 db_tag_target.vehicle_name = vehicle_name
             if props is not None:
                 db_tag_target.props = props
+            if flags is not None:
+                db_tag_target.flags = flags
 
             session.commit()
 
@@ -892,7 +902,7 @@ class TagCache(object):
                     .delete(synchronize_session=False)
                 )
 
-            query_stmt.delete(synchronize_session=False)
+            query_stmt.delete()
             session.commit()
 
             return self
@@ -1179,10 +1189,10 @@ class TagCache(object):
         begin_dt: datetime.datetime,
         end_dt: datetime.datetime,
         tag: str | Tag | BoundTag,
-        features: JsonType | None = None,
-        props: JsonType | None = None,
         tagset_namespace: str | None = None,
         tagset_version: str | None = None,
+        features: JsonType | None = None,
+        props: JsonType | None = None,
     ) -> Chainable[Self, TagRecordTable]:
         """
         Adds a tag record to the cache for the specified time range.
@@ -1192,14 +1202,14 @@ class TagCache(object):
         :param end_dt: End datetime of the tag record.
         :param tag: Tag name or ``Tag``/``BoundTag`` instance to add. If a ``Tag``/``BoundTag`` instance is provided,
                     its name is used.
-        :param features: Optional tag record features in JSON format, used to store preprocessed data for querying
-                         and filtering.
-        :param props: Optional tag record properties in JSON format.
         :param tagset_namespace: Namespace of the tagset that the tag belongs to. If the ``tag`` parameter is a
                                  ``BoundTag`` instance, this parameter will be ignored and the namespace from the
                                  instance will be used.
         :param tagset_version: Version of the tagset that the tag belongs to. If the ``tag`` parameter is a ``BoundTag``
                                instance, this parameter will be ignored and the version from the instance will be used.
+        :param features: Optional tag record features in JSON format, used to store preprocessed data for querying
+                         and filtering.
+        :param props: Optional tag record properties in JSON format.
         :return: Chainable self and the added ``TagRecordTable`` instance.
         """
         if is_tag_cache_strict_mode():
@@ -1234,10 +1244,10 @@ class TagCache(object):
         begin_dt: datetime.datetime | None = None,
         end_dt: datetime.datetime | None = None,
         tag: str | Tag | BoundTag | None = None,
-        features: JsonType | None = None,
-        props: JsonType | None = None,
         tagset_namespace: str | None = None,
         tagset_version: str | None = None,
+        features: JsonType | None = None,
+        props: JsonType | None = None,
         flags: int | None = None,
     ) -> Chainable[Self, TagRecordTable]:
         """
@@ -1245,20 +1255,20 @@ class TagCache(object):
 
         :param target_sqn: Sequence number of the tag record's target.
         :param sqn: Sequence number of the tag record to update.
-        :param begin_dt: New start datetime of the tag record (optional).
-        :param end_dt: New end datetime of the tag record (optional).
-        :param tag: New tag name or ``Tag``/``BoundTag`` instance to use (optional). If a ``Tag``/``BoundTag`` instance
-                    is provided, its name will be used.
+        :param begin_dt: New start datetime of the tag record.
+        :param end_dt: New end datetime of the tag record.
+        :param tag: New tag name or ``Tag``/``BoundTag`` instance to use. If a ``Tag``/``BoundTag`` instance is
+                    provided, its name will be used.
+        :param tagset_namespace: New namespace of the tagset that the tag belongs to. If the ``tag`` parameter is a
+                                 ``BoundTag`` instance, this parameter will be ignored and the namespace from the
+                                 instance will be used.
+        :param tagset_version: New version of the tagset that the tag belongs to. If the ``tag`` parameter is a
+                               ``BoundTag`` instance, this parameter will be ignored and the version from the instance
+                               will be used.
         :param features: New optional tag record features in JSON format, used to store preprocessed data for querying
                          and filtering.
         :param props: New optional tag record properties in JSON format.
-        :param tagset_namespace: New namespace of the tagset that the tag belongs to (optional). If the ``tag``
-                                 parameter is a ``BoundTag`` instance, this parameter will be ignored and the namespace
-                                 from the instance will be used.
-        :param tagset_version: New version of the tagset that the tag belongs to (optional). If the ``tag`` parameter
-                               is a ``BoundTag`` instance, this parameter will be ignored and the version from the
-                               instance will be used.
-        :param flags: New integer bitmask for status or metadata flags (optional).
+        :param flags: New integer bitmask for status or metadata flags.
         :return: Chainable self and the updated ``TagRecordTable`` instance.
         """
         with self.make_session() as session:
@@ -1459,38 +1469,38 @@ class TargetedTagCache(object):
         begin_dt: datetime.datetime | None,
         end_dt: datetime.datetime | None,
         tag: str | Tag | BoundTag,
-        features: JsonType | None = None,
-        props: JsonType | None = None,
         tagset_namespace: str | None = None,
         tagset_version: str | None = None,
+        features: JsonType | None = None,
+        props: JsonType | None = None,
     ) -> Chainable[Self, TagRecordTable]:
         result = self.cache.target_add_record(
             target_sqn=self.tag_target.sqn,
             begin_dt=begin_dt or self.tag_target.begin_dt,
             end_dt=end_dt or self.tag_target.end_dt,
             tag=tag,
-            features=features,
-            props=props,
             tagset_namespace=tagset_namespace,
             tagset_version=tagset_version,
+            features=features,
+            props=props,
         )
         return result.retarget(self)
 
     def add_record(
         self,
         tag: str | Tag | BoundTag,
-        features: JsonType | None = None,
-        props: JsonType | None = None,
         tagset_namespace: str | None = None,
         tagset_version: str | None = None,
+        features: JsonType | None = None,
+        props: JsonType | None = None,
     ) -> Chainable[Self, TagRecordTable]:
         result = self.add_ranged_record(
             begin_dt=self.tag_target.begin_dt,
             end_dt=self.tag_target.end_dt,
             tag=tag,
-            features=features,
             tagset_namespace=tagset_namespace,
             tagset_version=tagset_version,
+            features=features,
             props=props,
         )
         return result.retarget(self)
@@ -1502,10 +1512,10 @@ class TargetedTagCache(object):
         begin_dt: datetime.datetime | None = None,
         end_dt: datetime.datetime | None = None,
         tag: str | Tag | BoundTag | None = None,
-        features: JsonType | None = None,
-        props: JsonType | None = None,
         tagset_namespace: str | None = None,
         tagset_version: str | None = None,
+        features: JsonType | None = None,
+        props: JsonType | None = None,
         flags: int | None = None,
     ) -> Chainable[Self, TagRecordTable]:
         result = self.cache.target_update_record(
@@ -1514,10 +1524,10 @@ class TargetedTagCache(object):
             begin_dt=begin_dt,
             end_dt=end_dt,
             tag=tag,
-            features=features,
-            props=props,
             tagset_namespace=tagset_namespace,
             tagset_version=tagset_version,
+            features=features,
+            props=props,
             flags=flags,
         )
         return result.retarget(self)

{plexus_python_pulse_common-1.1.80.dist-info → plexus_python_pulse_common-1.1.81.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plexus-python-pulse-common
-Version: 1.1.80
+Version: 1.1.81
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13

{plexus_python_pulse_common-1.1.80.dist-info → plexus_python_pulse_common-1.1.81.dist-info}/RECORD

@@ -22,9 +22,9 @@ plexus/pulse/common/utils/pathutils.py,sha256=eYfNK48wf1xZGK2IbpKxYOn4skZhWWA8OT
 plexus/pulse/common/utils/s3utils.py,sha256=5q5wSOavt-n5EdrflQX7WPGgDeWQkGO9lG5Nq3QXjCk,35904
 plexus/pulse/common/utils/sqlutils.py,sha256=D6kTBjhO5YlNRt3uFlPt6z3uH61m9ajEzPYmsI6NoFc,231
 plexus/pulse/common/utils/strutils.py,sha256=PkmMHCcHN9vALCy_8fJTf00Dg7I2N4QTCXdBmB3t7rk,16440
-plexus/pulse/common/utils/tagutils.py,sha256=-3xizapJz4zj_sWkNNEkVvF9QTdgqCuyWuDz435o00w,66602
+plexus/pulse/common/utils/tagutils.py,sha256=V8eUxtWSijX6nHSCuRX2dTJz3why3TCOzPVK5YXt28s,66944
 plexus/pulse/common/utils/testutils.py,sha256=hKPRvoN4mg8QGQJH121l59a0uo8jN5rntGQAVYplGBw,6166
-plexus_python_pulse_common-1.1.80.dist-info/METADATA,sha256=TDJDV7lFVA3p5B9z-qyaNhanWZmRlXjoJltppqXPayY,1555
-plexus_python_pulse_common-1.1.80.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-plexus_python_pulse_common-1.1.80.dist-info/top_level.txt,sha256=ug_g7CVwaMQuas5UzAXbHUrQvKGCn8ezc6ZNvvRlJOE,7
-plexus_python_pulse_common-1.1.80.dist-info/RECORD,,
+plexus_python_pulse_common-1.1.81.dist-info/METADATA,sha256=i2uemuWFHDqKPkBBXnolVVef6PFFzCyu5UqgQeQ6Wag,1555
+plexus_python_pulse_common-1.1.81.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+plexus_python_pulse_common-1.1.81.dist-info/top_level.txt,sha256=ug_g7CVwaMQuas5UzAXbHUrQvKGCn8ezc6ZNvvRlJOE,7
+plexus_python_pulse_common-1.1.81.dist-info/RECORD,,