plexus-python-pulse-demeter 1.1.127__tar.gz → 1.1.128__tar.gz

{plexus_python_pulse_demeter-1.1.127 → plexus_python_pulse_demeter-1.1.128}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plexus-python-pulse-demeter
-Version: 1.1.127
+Version: 1.1.128
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13

{plexus_python_pulse_demeter-1.1.127 → plexus_python_pulse_demeter-1.1.128}/src/plexus/pulse/demeter/app/api/dataset_public_endpoints.py

@@ -1667,7 +1667,7 @@ class MetricsDisplayOperation(object):
 @singleton
 def registered_metrics_display_operations() -> dict[str, MetricsDisplayOperation]:
     """
-    Register metrics display operations for different benchmarks.
+    Register metrics display operations by benchmark name.
 
     Example:
 
@@ -1743,7 +1743,7 @@ def registered_metrics_display_operations() -> dict[str, MetricsDisplayOperation
     ...     detailed_metric_pivot_tables_maker,
     ... )
 
-    :return: A dictionary mapping benchmark names to their corresponding ``MetricsOperation``.
+    :return: Dictionary mapping benchmark names to their corresponding ``MetricsDisplayOperation``.
     """
     return {}
 

{plexus_python_pulse_demeter-1.1.127 → plexus_python_pulse_demeter-1.1.128}/src/plexus/pulse/demeter/app/api/tagging_endpoints.py

@@ -118,7 +118,7 @@ def tag_query_interpreter() -> Callable[[str], sa.ColumnElement[bool]]:
 
     def ast_to_sa_filter(ast: Expr) -> sa.ColumnElement[bool]:
         """
-        Converts the AST into an SQLAlchemy filter.
+        Convert the AST into an SQLAlchemy filter.
         """
         if isinstance(ast, TagQueryExpr):
             if ast.features_query is None:

{plexus_python_pulse_demeter-1.1.127 → plexus_python_pulse_demeter-1.1.128}/src/plexus/pulse/demeter/app/models/registry/__init__.py

@@ -20,9 +20,9 @@ class JobStatusFlag(enum.Flag):
     Comprehensive job status bitflags.
 
     Flags are grouped by functional categories with distinct bit ranges:
-    - progression: job lifecycle states (0x01 - 0x80)
-    - control: control/administrative requests (0x0100 - 0x8000)
-    - outcome: terminal outcomes (0x010000 - 0x800000)
+    - Progression: job lifecycle states (0x01 - 0x80).
+    - Control: control and administrative requests (0x0100 - 0x8000).
+    - Outcome: terminal states (0x010000 - 0x800000).
     """
     # Progression / lifecycle (ongoing states)
     Submitted = 0x01

{plexus_python_pulse_demeter-1.1.127 → plexus_python_pulse_demeter-1.1.128}/src/plexus/pulse/demeter/utils/datautils.py

@@ -57,11 +57,11 @@ def retrieve_dataset_metafile(
     dataset_path: Path | CloudPath,
 ) -> Result[DatasetMetafile | None, ValidationFailure]:
     """
-    Retrieve the dataset metafile for a given dataset path.
+    Retrieve the dataset metafile from a dataset root.
 
-    :param dataset_path: absolute path to the dataset root
+    :param dataset_path: Absolute path to the dataset root.
 
-    :return: Result containing optional ``DatasetMetafile``, or a ``ValidationFailure`` on error.
+    :return: Result containing an optional ``DatasetMetafile``, or a ``ValidationFailure`` on error.
     """
     dataset_metafile_path = dataset_path / dataset_metafile_filename()
 
@@ -83,12 +83,12 @@ def retrieve_sample_metafile_and_layout(
     layouts: list[SampleLayout],
 ) -> Result[tuple[SampleMetafile | None, SampleLayout | None], ValidationFailure]:
     """
-    Retrieve the sample metafile and corresponding layout for a given sample path.
+    Retrieve the sample metafile and its matching layout.
 
-    :param sample_path: absolute path to the sample root
-    :param layouts: list of available ``SampleLayout`` objects
+    :param sample_path: Absolute path to the sample root.
+    :param layouts: Available ``SampleLayout`` objects.
 
-    :return: Result containing optional tuple of ``SampleMetafile`` and ``SampleLayout``, or a ``ValidationFailure``
+    :return: Result containing an optional tuple of ``SampleMetafile`` and ``SampleLayout``, or a ``ValidationFailure``
              on error.
     """
     sample_metafile_path = sample_path / sample_metafile_filename()
@@ -132,13 +132,13 @@ def walk_standalone_sample(
     """
     Walk and validate a standalone sample against its layout.
 
-    :param dataset_path: absolute path to the dataset root
-    :param sample_path: absolute path to the sample root
-    :param layout: layout to validate against
-    :param layouts: list of available ``SampleLayout`` objects
-    :param ignore_metafile: whether to ignore the sample metafile during validation
+    :param dataset_path: Absolute path to the dataset root.
+    :param sample_path: Absolute path to the sample root.
+    :param layout: Layout to validate against.
+    :param layouts: Available ``SampleLayout`` objects.
+    :param ignore_metafile: Whether to ignore the sample metafile during validation.
 
-    :return: Iterator of Results containing ``StandaloneSample`` or ``ValidationFailure``
+    :return: Iterator of results containing ``StandaloneSample`` or ``ValidationFailure``.
     """
     if not dataset_path.is_absolute():
         raise ValueError(f"'{dataset_path}' is not an absolute path")
@@ -324,12 +324,12 @@ def validate_standalone_sample(
     """
     Validate a standalone sample against its layout.
 
-    :param dataset_root: absolute path to the dataset root
-    :param sample_root: absolute or relative path to the sample root
-    :param layout_reference: layout reference (name or UUID) to validate against
-    :param layouts: list of available ``SampleLayout`` objects
+    :param dataset_root: Absolute path to the dataset root.
+    :param sample_root: Absolute or relative path to the sample root.
+    :param layout_reference: Layout reference (name or UUID) to validate against.
+    :param layouts: Available ``SampleLayout`` objects.
 
-    :return: list of ``ValidationFailure`` objects encountered during validation
+    :return: List of ``ValidationFailure`` objects encountered during validation.
     """
     dataset_root_path = AnyPath(dataset_root)
     if not dataset_root_path.is_absolute():
@@ -367,11 +367,11 @@ def collect_standalone_dataset_samples(
     """
     Collect standalone samples from a dataset root.
 
-    :param dataset_root: absolute path to the dataset root
-    :param layouts: list of available ``SampleLayout`` objects
+    :param dataset_root: Absolute path to the dataset root.
+    :param layouts: Available ``SampleLayout`` objects.
 
-    :return: tuple containing optional ``StandaloneDataset``, list of ``StandaloneSample``, and list of
-             ``ValidationFailure`` objects
+    :return: Tuple containing an optional ``StandaloneDataset``, a list of ``StandaloneSample``, and a list of
+             ``ValidationFailure`` objects.
     """
     dataset_root_path = AnyPath(dataset_root)
     if not dataset_root_path.is_absolute():

{plexus_python_pulse_demeter-1.1.127 → plexus_python_pulse_demeter-1.1.128}/src/plexus_python_pulse_demeter.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plexus-python-pulse-demeter
-Version: 1.1.127
+Version: 1.1.128
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13