ob-metaflow-stubs 6.0.3.164__py2.py3-none-any.whl → 6.0.3.165__py2.py3-none-any.whl

metaflow-stubs/cards.pyi

@@ -1,7 +1,7 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
 # MF version: 2.15.11.1+obcheckpoint(0.2.1);ob(v1)                                                   #
-# Generated on 2025-05-07T07:24:19.632241                                                            #
+# Generated on 2025-05-08T08:48:06.175074                                                            #
 ######################################################################################################
 
 from __future__ import annotations

metaflow-stubs/cli.pyi

@@ -1,7 +1,7 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
 # MF version: 2.15.11.1+obcheckpoint(0.2.1);ob(v1)                                                   #
-# Generated on 2025-05-07T07:24:19.651521                                                            #
+# Generated on 2025-05-08T08:48:06.191460                                                            #
 ######################################################################################################
 
 from __future__ import annotations

metaflow-stubs/cli_components/__init__.pyi

@@ -1,7 +1,7 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
 # MF version: 2.15.11.1+obcheckpoint(0.2.1);ob(v1)                                                   #
-# Generated on 2025-05-07T07:24:19.649504                                                            #
+# Generated on 2025-05-08T08:48:06.190260                                                            #
 ######################################################################################################
 
 from __future__ import annotations

metaflow-stubs/cli_components/utils.pyi

@@ -1,7 +1,7 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
 # MF version: 2.15.11.1+obcheckpoint(0.2.1);ob(v1)                                                   #
-# Generated on 2025-05-07T07:24:19.679719                                                            #
+# Generated on 2025-05-08T08:48:06.217057                                                            #
 ######################################################################################################
 
 from __future__ import annotations

metaflow-stubs/client/__init__.pyi

@@ -1,7 +1,7 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
 # MF version: 2.15.11.1+obcheckpoint(0.2.1);ob(v1)                                                   #
-# Generated on 2025-05-07T07:24:19.636541                                                            #
+# Generated on 2025-05-08T08:48:06.179400                                                            #
 ######################################################################################################
 
 from __future__ import annotations

metaflow-stubs/client/core.pyi

@@ -1,20 +1,20 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
 # MF version: 2.15.11.1+obcheckpoint(0.2.1);ob(v1)                                                   #
-# Generated on 2025-05-07T07:24:19.641062                                                            #
+# Generated on 2025-05-08T08:48:06.183787                                                            #
 ######################################################################################################
 
 from __future__ import annotations
 
-import metaflow
 import typing
+import metaflow
 if typing.TYPE_CHECKING:
+    import datetime
+    import tempfile
     import tarfile
-    import metaflow.events
     import metaflow.client.core
     import typing
-    import tempfile
-    import datetime
+    import metaflow.events
 
 from ..metaflow_current import current as current
 from ..events import Trigger as Trigger

metaflow-stubs/client/filecache.pyi

@@ -1,7 +1,7 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
 # MF version: 2.15.11.1+obcheckpoint(0.2.1);ob(v1)                                                   #
-# Generated on 2025-05-07T07:24:19.674716                                                            #
+# Generated on 2025-05-08T08:48:06.212112                                                            #
 ######################################################################################################
 
 from __future__ import annotations

metaflow-stubs/events.pyi

@@ -1,15 +1,15 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
 # MF version: 2.15.11.1+obcheckpoint(0.2.1);ob(v1)                                                   #
-# Generated on 2025-05-07T07:24:19.633014                                                            #
+# Generated on 2025-05-08T08:48:06.175995                                                            #
 ######################################################################################################
 
 from __future__ import annotations
 
 import typing
 if typing.TYPE_CHECKING:
-    import metaflow.events
     import metaflow
+    import metaflow.events
 
 
 TYPE_CHECKING: bool

metaflow-stubs/exception.pyi

@@ -1,7 +1,7 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
 # MF version: 2.15.11.1+obcheckpoint(0.2.1);ob(v1)                                                   #
-# Generated on 2025-05-07T07:24:19.624650                                                            #
+# Generated on 2025-05-08T08:48:06.167722                                                            #
 ######################################################################################################
 
 from __future__ import annotations

metaflow-stubs/flowspec.pyi

@@ -1,7 +1,7 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
 # MF version: 2.15.11.1+obcheckpoint(0.2.1);ob(v1)                                                   #
-# Generated on 2025-05-07T07:24:19.629278                                                            #
+# Generated on 2025-05-08T08:48:06.172318                                                            #
 ######################################################################################################
 
 from __future__ import annotations
@@ -9,11 +9,11 @@ from __future__ import annotations
 import typing
 import metaflow
 if typing.TYPE_CHECKING:
-    import metaflow.exception
     import metaflow.unbounded_foreach
-    import metaflow.flowspec
     import metaflow.datastore.inputs
     import typing
+    import metaflow.flowspec
+    import metaflow.exception
 
 from . import parameters as parameters
 from .parameters import DelayedEvaluationParameter as DelayedEvaluationParameter

metaflow-stubs/generated_for.txt

@@ -1 +1 @@
-2.15.11.1+obcheckpoint(0.2.1);ob(v1) 2025-05-07T07:24:19.620933
+2.15.11.1+obcheckpoint(0.2.1);ob(v1) 2025-05-08T08:48:06.164100

metaflow-stubs/includefile.pyi

@@ -1,17 +1,17 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
 # MF version: 2.15.11.1+obcheckpoint(0.2.1);ob(v1)                                                   #
-# Generated on 2025-05-07T07:24:19.635721                                                            #
+# Generated on 2025-05-08T08:48:06.178670                                                            #
 ######################################################################################################
 
 from __future__ import annotations
 
-import metaflow
 import typing
+import metaflow
 if typing.TYPE_CHECKING:
     import metaflow._vendor.click.types
-    import metaflow.parameters
     import typing
+    import metaflow.parameters
 
 from ._vendor import click as click
 from .exception import MetaflowException as MetaflowException

metaflow-stubs/info_file.pyi

@@ -1,7 +1,7 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
 # MF version: 2.15.11.1+obcheckpoint(0.2.1);ob(v1)                                                   #
-# Generated on 2025-05-07T07:24:19.623877                                                            #
+# Generated on 2025-05-08T08:48:06.166958                                                            #
 ######################################################################################################
 
 from __future__ import annotations

metaflow-stubs/metadata_provider/__init__.pyi

@@ -1,7 +1,7 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
 # MF version: 2.15.11.1+obcheckpoint(0.2.1);ob(v1)                                                   #
-# Generated on 2025-05-07T07:24:19.628169                                                            #
+# Generated on 2025-05-08T08:48:06.171250                                                            #
 ######################################################################################################
 
 from __future__ import annotations

metaflow-stubs/metadata_provider/heartbeat.pyi

@@ -1,7 +1,7 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
 # MF version: 2.15.11.1+obcheckpoint(0.2.1);ob(v1)                                                   #
-# Generated on 2025-05-07T07:24:19.658713                                                            #
+# Generated on 2025-05-08T08:48:06.195775                                                            #
 ######################################################################################################
 
 from __future__ import annotations

metaflow-stubs/metadata_provider/metadata.pyi

@@ -1,7 +1,7 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
 # MF version: 2.15.11.1+obcheckpoint(0.2.1);ob(v1)                                                   #
-# Generated on 2025-05-07T07:24:19.658128                                                            #
+# Generated on 2025-05-08T08:48:06.195266                                                            #
 ######################################################################################################
 
 from __future__ import annotations

metaflow-stubs/metadata_provider/util.pyi

@@ -1,7 +1,7 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
 # MF version: 2.15.11.1+obcheckpoint(0.2.1);ob(v1)                                                   #
-# Generated on 2025-05-07T07:24:19.658439                                                            #
+# Generated on 2025-05-08T08:48:06.195506                                                            #
 ######################################################################################################
 
 from __future__ import annotations

metaflow-stubs/metaflow_config.pyi

@@ -1,7 +1,7 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
 # MF version: 2.15.11.1+obcheckpoint(0.2.1);ob(v1)                                                   #
-# Generated on 2025-05-07T07:24:19.625758                                                            #
+# Generated on 2025-05-08T08:48:06.168825                                                            #
 ######################################################################################################
 
 from __future__ import annotations

metaflow-stubs/metaflow_current.pyi

@@ -1,21 +1,21 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
 # MF version: 2.15.11.1+obcheckpoint(0.2.1);ob(v1)                                                   #
-# Generated on 2025-05-07T07:24:19.775718                                                            #
+# Generated on 2025-05-08T08:48:06.310817                                                            #
 ######################################################################################################
 
 from __future__ import annotations
 
 import typing
 if typing.TYPE_CHECKING:
-    import metaflow.metaflow_current
-    import metaflow.events
-    import metaflow.mf_extensions.obcheckpoint.plugins.machine_learning_utilities.hf_hub.decorator
-    import metaflow
-    import typing
     import metaflow.mf_extensions.obcheckpoint.plugins.machine_learning_utilities.checkpoints.decorator
     import metaflow.mf_extensions.obcheckpoint.plugins.machine_learning_utilities.modeling_utils.core
+    import metaflow
+    import typing
+    import metaflow.mf_extensions.obcheckpoint.plugins.machine_learning_utilities.hf_hub.decorator
+    import metaflow.events
     import metaflow.plugins.cards.component_serializer
+    import metaflow.metaflow_current
 
 
 TYPE_CHECKING: bool
@@ -228,125 +228,21 @@ class Current(object, metaclass=type):
     def graph(self):
         ...
     @property
-    def checkpoint(self) -> "metaflow.mf_extensions.obcheckpoint.plugins.machine_learning_utilities.checkpoints.decorator.CurrentCheckpointer":
-        """
-        (only in the presence of the @checkpoint decorator)
-        
-        The `@checkpoint` decorator makes saving/loading checkpoints available through the `current.checkpoint`.
-        The object exposes `save`/`load`/`list` methods for saving/loading checkpoints.
-        
-        You can check if a checkpoint is loaded by `current.checkpoint.is_loaded` and get the checkpoint information
-        by using `current.checkpoint.info`. The `current.checkpoint.directory` returns the path to the checkpoint directory
-        where the checkpoint maybe loaded or saved.
-        
-        Usage (Saving Checkpoints):
-        -------
-        ```
-        @checkpoint
-        @step
-        def train(self):
-            model = create_model(self.parameters, checkpoint_path = None)
-            for i in range(self.epochs):
-                # some training logic
-                loss = model.train(self.dataset)
-                if i % 10 == 0:
-                    model.save(
-                        current.checkpoint.directory,
-                    )
-                    # saves the contents of the `current.checkpoint.directory` as a checkpoint
-                    # and returns a reference dictionary to the checkpoint saved in the datastore
-                    self.latest_checkpoint = current.checkpoint.save(
-                        name="epoch_checkpoint",
-                        metadata={
-                            "epoch": i,
-                            "loss": loss,
-                        }
-                    )
-        ```
-        Usage (Using Loaded Checkpoints):
-        -------
-        ```
-        @retry(times=3)
-        @checkpoint
-        @step
-        def train(self):
-            # Assume that the task has restarted and the previous attempt of the task
-            # saved a checkpoint
-            checkpoint_path = None
-            if current.checkpoint.is_loaded: # Check if a checkpoint is loaded
-                print("Loaded checkpoint from the previous attempt")
-                checkpoint_path = current.checkpoint.directory
-        
-            model = create_model(self.parameters, checkpoint_path = checkpoint_path)
-            for i in range(self.epochs):
-                ...
-        ```
-        
-        Returns
-        -------
-        CurrentCheckpointer
-            The object for handling checkpointing within a step.
-        """
-        ...
-    @property
-    def model(self) -> "metaflow.mf_extensions.obcheckpoint.plugins.machine_learning_utilities.modeling_utils.core.ModelSerializer":
+    def card(self) -> "metaflow.plugins.cards.component_serializer.CardComponentCollector":
         """
-        (only in the presence of the @model decorator)
-        
-        The object used for loading / saving models.
-        `current.model` exposes a `save` method to save models and a `load` method to load models.
-        `current.model.loaded` exposes the paths to the models loaded via the `load` argument in the @model decorator
-        or models loaded via `current.model.load`.
-        
-        Usage (Saving a model):
-        -------
-        
-        ```
-        @model
-        @step
-        def train(self):
-            # current.model.save returns a dictionary reference to the model saved
-            self.my_model = current.model.save(
-                path_to_my_model,
-                label="my_model",
-                metadata={
-                    "epochs": 10,
-                    "batch-size": 32,
-                    "learning-rate": 0.001,
-                }
-            )
-            self.next(self.test)
-        
-        @model(load="my_model")
-        @step
-        def test(self):
-            # `current.model.loaded` returns a dictionary of the loaded models
-            # where the key is the name of the artifact and the value is the path to the model
-            print(os.listdir(current.model.loaded["my_model"]))
-            self.next(self.end)
-        ```
-        
-        Usage (Loading models):
-        -------
+        (only in the presence of the @card decorator)
         
-        ```
-        @step
-        def train(self):
-            # current.model.load returns the path to the model loaded
-            checkpoint_path = current.model.load(
-                self.checkpoint_key,
-            )
-            model_path = current.model.load(
-                self.model,
-            )
-            self.next(self.test)
-        ```
+        The `@card` decorator makes the cards available through the `current.card`
+        object. If multiple `@card` decorators are present, you can add an `ID` to
+        distinguish between them using `@card(id=ID)` as the decorator. You will then
+        be able to access that specific card using `current.card[ID].
         
+        Methods available are `append` and `extend`
         
         Returns
         -------
-        ModelSerializer
-            The object used for loading / saving models.
+        CardComponentCollector
+            The or one of the cards attached to this step.
         """
         ...
     @property
@@ -448,21 +344,125 @@ class Current(object, metaclass=type):
         """
         ...
     @property
-    def card(self) -> "metaflow.plugins.cards.component_serializer.CardComponentCollector":
+    def model(self) -> "metaflow.mf_extensions.obcheckpoint.plugins.machine_learning_utilities.modeling_utils.core.ModelSerializer":
         """
-        (only in the presence of the @card decorator)
+        (only in the presence of the @model decorator)
         
-        The `@card` decorator makes the cards available through the `current.card`
-        object. If multiple `@card` decorators are present, you can add an `ID` to
-        distinguish between them using `@card(id=ID)` as the decorator. You will then
-        be able to access that specific card using `current.card[ID].
+        The object used for loading / saving models.
+        `current.model` exposes a `save` method to save models and a `load` method to load models.
+        `current.model.loaded` exposes the paths to the models loaded via the `load` argument in the @model decorator
+        or models loaded via `current.model.load`.
+        
+        Usage (Saving a model):
+        -------
+        
+        ```
+        @model
+        @step
+        def train(self):
+            # current.model.save returns a dictionary reference to the model saved
+            self.my_model = current.model.save(
+                path_to_my_model,
+                label="my_model",
+                metadata={
+                    "epochs": 10,
+                    "batch-size": 32,
+                    "learning-rate": 0.001,
+                }
+            )
+            self.next(self.test)
+        
+        @model(load="my_model")
+        @step
+        def test(self):
+            # `current.model.loaded` returns a dictionary of the loaded models
+            # where the key is the name of the artifact and the value is the path to the model
+            print(os.listdir(current.model.loaded["my_model"]))
+            self.next(self.end)
+        ```
+        
+        Usage (Loading models):
+        -------
+        
+        ```
+        @step
+        def train(self):
+            # current.model.load returns the path to the model loaded
+            checkpoint_path = current.model.load(
+                self.checkpoint_key,
+            )
+            model_path = current.model.load(
+                self.model,
+            )
+            self.next(self.test)
+        ```
         
-        Methods available are `append` and `extend`
         
         Returns
         -------
-        CardComponentCollector
-            The or one of the cards attached to this step.
+        ModelSerializer
+            The object used for loading / saving models.
+        """
+        ...
+    @property
+    def checkpoint(self) -> "metaflow.mf_extensions.obcheckpoint.plugins.machine_learning_utilities.checkpoints.decorator.CurrentCheckpointer":
+        """
+        (only in the presence of the @checkpoint decorator)
+        
+        The `@checkpoint` decorator makes saving/loading checkpoints available through the `current.checkpoint`.
+        The object exposes `save`/`load`/`list` methods for saving/loading checkpoints.
+        
+        You can check if a checkpoint is loaded by `current.checkpoint.is_loaded` and get the checkpoint information
+        by using `current.checkpoint.info`. The `current.checkpoint.directory` returns the path to the checkpoint directory
+        where the checkpoint maybe loaded or saved.
+        
+        Usage (Saving Checkpoints):
+        -------
+        ```
+        @checkpoint
+        @step
+        def train(self):
+            model = create_model(self.parameters, checkpoint_path = None)
+            for i in range(self.epochs):
+                # some training logic
+                loss = model.train(self.dataset)
+                if i % 10 == 0:
+                    model.save(
+                        current.checkpoint.directory,
+                    )
+                    # saves the contents of the `current.checkpoint.directory` as a checkpoint
+                    # and returns a reference dictionary to the checkpoint saved in the datastore
+                    self.latest_checkpoint = current.checkpoint.save(
+                        name="epoch_checkpoint",
+                        metadata={
+                            "epoch": i,
+                            "loss": loss,
+                        }
+                    )
+        ```
+        Usage (Using Loaded Checkpoints):
+        -------
+        ```
+        @retry(times=3)
+        @checkpoint
+        @step
+        def train(self):
+            # Assume that the task has restarted and the previous attempt of the task
+            # saved a checkpoint
+            checkpoint_path = None
+            if current.checkpoint.is_loaded: # Check if a checkpoint is loaded
+                print("Loaded checkpoint from the previous attempt")
+                checkpoint_path = current.checkpoint.directory
+        
+            model = create_model(self.parameters, checkpoint_path = checkpoint_path)
+            for i in range(self.epochs):
+                ...
+        ```
+        
+        Returns
+        -------
+        CurrentCheckpointer
+            The object for handling checkpointing within a step.
         """
         ...
     @property

metaflow-stubs/metaflow_git.pyi

@@ -1,7 +1,7 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
 # MF version: 2.15.11.1+obcheckpoint(0.2.1);ob(v1)                                                   #
-# Generated on 2025-05-07T07:24:19.632435                                                            #
+# Generated on 2025-05-08T08:48:06.175266                                                            #
 ######################################################################################################
 
 from __future__ import annotations

metaflow-stubs/mf_extensions/__init__.pyi

@@ -1,6 +1,6 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
 # MF version: 2.15.11.1+obcheckpoint(0.2.1);ob(v1)                                                   #
-# Generated on 2025-05-07T07:24:19.634319                                                            #
+# Generated on 2025-05-08T08:48:06.177289                                                            #
 ######################################################################################################
 

metaflow-stubs/mf_extensions/obcheckpoint/__init__.pyi

@@ -1,6 +1,6 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
 # MF version: 2.15.11.1+obcheckpoint(0.2.1);ob(v1)                                                   #
-# Generated on 2025-05-07T07:24:19.644067                                                            #
+# Generated on 2025-05-08T08:48:06.186798                                                            #
 ######################################################################################################
 

metaflow-stubs/mf_extensions/obcheckpoint/plugins/__init__.pyi

@@ -1,6 +1,6 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
 # MF version: 2.15.11.1+obcheckpoint(0.2.1);ob(v1)                                                   #
-# Generated on 2025-05-07T07:24:19.644126                                                            #
+# Generated on 2025-05-08T08:48:06.186857                                                            #
 ######################################################################################################
 

metaflow-stubs/mf_extensions/obcheckpoint/plugins/machine_learning_utilities/__init__.pyi

@@ -1,6 +1,6 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
 # MF version: 2.15.11.1+obcheckpoint(0.2.1);ob(v1)                                                   #
-# Generated on 2025-05-07T07:24:19.644200                                                            #
+# Generated on 2025-05-08T08:48:06.186915                                                            #
 ######################################################################################################
 

metaflow-stubs/mf_extensions/obcheckpoint/plugins/machine_learning_utilities/card_utils/__init__.pyi

@@ -1,6 +1,6 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
 # MF version: 2.15.11.1+obcheckpoint(0.2.1);ob(v1)                                                   #
-# Generated on 2025-05-07T07:24:19.703720                                                            #
+# Generated on 2025-05-08T08:48:06.240078                                                            #
 ######################################################################################################
 

metaflow-stubs/mf_extensions/obcheckpoint/plugins/machine_learning_utilities/card_utils/async_cards.pyi

@@ -1,7 +1,7 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
 # MF version: 2.15.11.1+obcheckpoint(0.2.1);ob(v1)                                                   #
-# Generated on 2025-05-07T07:24:19.704444                                                            #
+# Generated on 2025-05-08T08:48:06.240805                                                            #
 ######################################################################################################
 
 from __future__ import annotations

metaflow-stubs/mf_extensions/obcheckpoint/plugins/machine_learning_utilities/card_utils/deco_injection_mixin.pyi

@@ -1,7 +1,7 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
 # MF version: 2.15.11.1+obcheckpoint(0.2.1);ob(v1)                                                   #
-# Generated on 2025-05-07T07:24:19.703767                                                            #
+# Generated on 2025-05-08T08:48:06.240125                                                            #
 ######################################################################################################
 
 from __future__ import annotations

metaflow-stubs/mf_extensions/obcheckpoint/plugins/machine_learning_utilities/card_utils/extra_components.pyi

@@ -1,7 +1,7 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
 # MF version: 2.15.11.1+obcheckpoint(0.2.1);ob(v1)                                                   #
-# Generated on 2025-05-07T07:24:19.746120                                                            #
+# Generated on 2025-05-08T08:48:06.281669                                                            #
 ######################################################################################################
 
 from __future__ import annotations

metaflow-stubs/mf_extensions/obcheckpoint/plugins/machine_learning_utilities/checkpoints/__init__.pyi

@@ -1,6 +1,6 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
 # MF version: 2.15.11.1+obcheckpoint(0.2.1);ob(v1)                                                   #
-# Generated on 2025-05-07T07:24:19.644256                                                            #
+# Generated on 2025-05-08T08:48:06.186969                                                            #
 ######################################################################################################
 

metaflow-stubs/mf_extensions/obcheckpoint/plugins/machine_learning_utilities/checkpoints/cards/__init__.pyi

@@ -1,6 +1,6 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
 # MF version: 2.15.11.1+obcheckpoint(0.2.1);ob(v1)                                                   #
-# Generated on 2025-05-07T07:24:19.705211                                                            #
+# Generated on 2025-05-08T08:48:06.241611                                                            #
 ######################################################################################################