metaflow-stubs 2.12.22__py2.py3-none-any.whl → 2.12.24__py2.py3-none-any.whl

metaflow-stubs/plugins/aws/step_functions/step_functions_decorator.pyi

@@ -1,7 +1,7 @@
 ##################################################################################
 #                       Auto-generated Metaflow stub file                        #
-# MF version: 2.12.22                                                            #
-# Generated on 2024-09-20T00:45:49.699335                                        #
+# MF version: 2.12.24                                                            #
+# Generated on 2024-10-04T11:37:47.069595                                        #
 ##################################################################################
 
 from __future__ import annotations
@@ -11,6 +11,9 @@ if typing.TYPE_CHECKING:
     import metaflow.decorators
 
 class MetaDatum(tuple, metaclass=type):
+    """
+    MetaDatum(field, value, type, tags)
+    """
     @staticmethod
     def __new__(_cls, field, value, type, tags):
         """

metaflow-stubs/plugins/aws/step_functions/step_functions_deployer.pyi

@@ -1,7 +1,7 @@
 ##################################################################################
 #                       Auto-generated Metaflow stub file                        #
-# MF version: 2.12.22                                                            #
-# Generated on 2024-09-20T00:45:49.704019                                        #
+# MF version: 2.12.24                                                            #
+# Generated on 2024-10-04T11:37:47.074399                                        #
 ##################################################################################
 
 from __future__ import annotations
@@ -9,7 +9,6 @@ from __future__ import annotations
 import typing
 if typing.TYPE_CHECKING:
     import metaflow.runner.deployer
-    import metaflow.runner.subprocess_manager
 
 class StepFunctions(object, metaclass=type):
     def __init__(self, name, graph, flow, code_package_sha, code_package_url, production_token, metadata, flow_datastore, environment, event_logger, monitor, tags = None, namespace = None, username = None, max_workers = None, workflow_timeout = None, is_project = False, use_distributed_map = False):
@@ -43,6 +42,30 @@ class StepFunctions(object, metaclass=type):
     ...
 
 class DeployerImpl(object, metaclass=type):
+    """
+    Base class for deployer implementations. Each implementation should define a TYPE
+    class variable that matches the name of the CLI group.
+    
+    Parameters
+    ----------
+    flow_file : str
+        Path to the flow file to deploy.
+    show_output : bool, default True
+        Show the 'stdout' and 'stderr' to the console by default.
+    profile : Optional[str], default None
+        Metaflow profile to use for the deployment. If not specified, the default
+        profile is used.
+    env : Optional[Dict], default None
+        Additional environment variables to set for the deployment.
+    cwd : Optional[str], default None
+        The directory to run the subprocess in; if not specified, the current
+        directory is used.
+    file_read_timeout : int, default 3600
+        The timeout until which we try to read the deployer attribute file.
+    **kwargs : Any
+        Additional arguments that you would pass to `python myflow.py` before
+        the deployment command.
+    """
     def __init__(self, flow_file: str, show_output: bool = True, profile: typing.Optional[str] = None, env: typing.Optional[typing.Dict] = None, cwd: typing.Optional[str] = None, file_read_timeout: int = 3600, **kwargs):
         ...
     def __enter__(self) -> metaflow.runner.deployer.DeployerImpl:
@@ -81,11 +104,25 @@ class DeployerImpl(object, metaclass=type):
     ...
 
 class DeployedFlow(object, metaclass=type):
+    """
+    DeployedFlow class represents a flow that has been deployed.
+    
+    Parameters
+    ----------
+    deployer : DeployerImpl
+        Instance of the deployer implementation.
+    """
     def __init__(self, deployer: metaflow.runner.deployer.DeployerImpl):
         ...
     ...
 
 class TriggeredRun(object, metaclass=type):
+    """
+    TriggeredRun class represents a run that has been triggered on a production orchestrator.
+    
+    Only when the `start` task starts running, the `run` object corresponding to the run
+    becomes available.
+    """
     def __init__(self, deployer: metaflow.runner.deployer.DeployerImpl, content: str):
         ...
     def wait_for_run(self, timeout = None):
@@ -146,7 +183,7 @@ def get_lower_level_group(api, top_level_kwargs: typing.Dict, _type: typing.Opti
     """
     ...
 
-def handle_timeout(tfp_runner_attribute, command_obj: metaflow.runner.subprocess_manager.CommandManager, file_read_timeout: int):
+def handle_timeout(tfp_runner_attribute, command_obj: "CommandManager", file_read_timeout: int):
     """
     Handle the timeout for a running subprocess command that reads a file
     and raises an error with appropriate logs if a TimeoutError occurs.
@@ -261,6 +298,14 @@ def trigger(instance: metaflow.runner.deployer.DeployedFlow, **kwargs):
     ...
 
 class StepFunctionsDeployer(metaflow.runner.deployer.DeployerImpl, metaclass=type):
+    """
+    Deployer implementation for AWS Step Functions.
+    
+    Attributes
+    ----------
+    TYPE : ClassVar[Optional[str]]
+        The type of the deployer, which is "step-functions".
+    """
     def __init__(self, deployer_kwargs, **kwargs):
         """
         Initialize the StepFunctionsDeployer.

metaflow-stubs/plugins/azure/__init__.pyi

@@ -1,7 +1,7 @@
 ##################################################################################
 #                       Auto-generated Metaflow stub file                        #
-# MF version: 2.12.22                                                            #
-# Generated on 2024-09-20T00:45:49.636694                                        #
+# MF version: 2.12.24                                                            #
+# Generated on 2024-10-04T11:37:47.002298                                        #
 ##################################################################################
 
 from __future__ import annotations

metaflow-stubs/plugins/azure/azure_credential.pyi

@@ -1,7 +1,7 @@
 ##################################################################################
 #                       Auto-generated Metaflow stub file                        #
-# MF version: 2.12.22                                                            #
-# Generated on 2024-09-20T00:45:49.696129                                        #
+# MF version: 2.12.24                                                            #
+# Generated on 2024-10-04T11:37:47.062464                                        #
 ##################################################################################
 
 from __future__ import annotations

metaflow-stubs/plugins/azure/azure_exceptions.pyi

@@ -1,7 +1,7 @@
 ##################################################################################
 #                       Auto-generated Metaflow stub file                        #
-# MF version: 2.12.22                                                            #
-# Generated on 2024-09-20T00:45:49.696374                                        #
+# MF version: 2.12.24                                                            #
+# Generated on 2024-10-04T11:37:47.062714                                        #
 ##################################################################################
 
 from __future__ import annotations

metaflow-stubs/plugins/azure/azure_secret_manager_secrets_provider.pyi

@@ -1,16 +1,16 @@
 ##################################################################################
 #                       Auto-generated Metaflow stub file                        #
-# MF version: 2.12.22                                                            #
-# Generated on 2024-09-20T00:45:49.697918                                        #
+# MF version: 2.12.24                                                            #
+# Generated on 2024-10-04T11:37:47.064155                                        #
 ##################################################################################
 
 from __future__ import annotations
 
 import typing
 if typing.TYPE_CHECKING:
-    import abc
-    import metaflow.plugins.secrets
     import metaflow.exception
+    import metaflow.plugins.secrets
+    import abc
 
 class SecretsProvider(abc.ABC, metaclass=abc.ABCMeta):
     def get_secret_as_dict(self, secret_id, options = {}, role = None) -> typing.Dict[str, str]:
@@ -34,21 +34,39 @@ def create_cacheable_azure_credential():
     ...
 
 class MetaflowAzureKeyVaultBadVault(metaflow.exception.MetaflowException, metaclass=type):
+    """
+    Raised when the secretid is fully qualified but does not have the right key vault domain
+    """
     ...
 
 class MetaflowAzureKeyVaultBadSecretType(metaflow.exception.MetaflowException, metaclass=type):
+    """
+    Raised when the secret type is anything except secrets
+    """
     ...
 
 class MetaflowAzureKeyVaultBadSecretPath(metaflow.exception.MetaflowException, metaclass=type):
+    """
+    Raised when the secret path does not match to expected length
+    """
     ...
 
 class MetaflowAzureKeyVaultBadSecretName(metaflow.exception.MetaflowException, metaclass=type):
+    """
+    Raised when the secret name does not match expected pattern
+    """
     ...
 
 class MetaflowAzureKeyVaultBadSecretVersion(metaflow.exception.MetaflowException, metaclass=type):
+    """
+    Raised when the secret version does not match expected pattern
+    """
     ...
 
 class MetaflowAzureKeyVaultBadSecret(metaflow.exception.MetaflowException, metaclass=type):
+    """
+    Raised when the secret does not match supported patterns in Metaflow
+    """
     ...
 
 class AzureKeyVaultSecretsProvider(metaflow.plugins.secrets.SecretsProvider, metaclass=abc.ABCMeta):

metaflow-stubs/plugins/azure/azure_utils.pyi

@@ -1,7 +1,7 @@
 ##################################################################################
 #                       Auto-generated Metaflow stub file                        #
-# MF version: 2.12.22                                                            #
-# Generated on 2024-09-20T00:45:49.696878                                        #
+# MF version: 2.12.24                                                            #
+# Generated on 2024-10-04T11:37:47.063216                                        #
 ##################################################################################
 
 from __future__ import annotations

metaflow-stubs/plugins/azure/blob_service_client_factory.pyi

@@ -1,7 +1,7 @@
 ##################################################################################
 #                       Auto-generated Metaflow stub file                        #
-# MF version: 2.12.22                                                            #
-# Generated on 2024-09-20T00:45:49.697283                                        #
+# MF version: 2.12.24                                                            #
+# Generated on 2024-10-04T11:37:47.063619                                        #
 ##################################################################################
 
 from __future__ import annotations

metaflow-stubs/plugins/azure/includefile_support.pyi

@@ -1,7 +1,7 @@
 ##################################################################################
 #                       Auto-generated Metaflow stub file                        #
-# MF version: 2.12.22                                                            #
-# Generated on 2024-09-20T00:45:49.627153                                        #
+# MF version: 2.12.24                                                            #
+# Generated on 2024-10-04T11:37:46.992558                                        #
 ##################################################################################
 
 from __future__ import annotations

metaflow-stubs/plugins/cards/__init__.pyi

@@ -1,7 +1,7 @@
 ##################################################################################
 #                       Auto-generated Metaflow stub file                        #
-# MF version: 2.12.22                                                            #
-# Generated on 2024-09-20T00:45:49.634305                                        #
+# MF version: 2.12.24                                                            #
+# Generated on 2024-10-04T11:37:46.998452                                        #
 ##################################################################################
 
 from __future__ import annotations

metaflow-stubs/plugins/cards/card_cli.pyi

@@ -1,7 +1,7 @@
 ##################################################################################
 #                       Auto-generated Metaflow stub file                        #
-# MF version: 2.12.22                                                            #
-# Generated on 2024-09-20T00:45:49.685986                                        #
+# MF version: 2.12.24                                                            #
+# Generated on 2024-10-04T11:37:47.045764                                        #
 ##################################################################################
 
 from __future__ import annotations
@@ -11,10 +11,59 @@ if typing.TYPE_CHECKING:
     import metaflow.client.core
     import metaflow.exception
     import typing
-    import datetime
     import metaflow.parameters
+    import datetime
 
 class Task(metaflow.client.core.MetaflowObject, metaclass=type):
+    """
+    A `Task` represents an execution of a `Step`.
+    
+    It contains all `DataArtifact` objects produced by the task as
+    well as metadata related to execution.
+    
+    Note that the `@retry` decorator may cause multiple attempts of
+    the task to be present. Usually you want the latest attempt, which
+    is what instantiating a `Task` object returns by default. If
+    you need to e.g. retrieve logs from a failed attempt, you can
+    explicitly get information about a specific attempt by using the
+    following syntax when creating a task:
+    
+    `Task('flow/run/step/task', attempt=<attempt>)`
+    
+    where `attempt=0` corresponds to the first attempt etc.
+    
+    Attributes
+    ----------
+    metadata : List[Metadata]
+        List of all metadata events associated with the task.
+    metadata_dict : Dict[str, str]
+        A condensed version of `metadata`: A dictionary where keys
+        are names of metadata events and values the latest corresponding event.
+    data : MetaflowData
+        Container of all data artifacts produced by this task. Note that this
+        call downloads all data locally, so it can be slower than accessing
+        artifacts individually. See `MetaflowData` for more information.
+    artifacts : MetaflowArtifacts
+        Container of `DataArtifact` objects produced by this task.
+    successful : bool
+        True if the task completed successfully.
+    finished : bool
+        True if the task completed.
+    exception : object
+        Exception raised by this task if there was one.
+    finished_at : datetime
+        Time this task finished.
+    runtime_name : str
+        Runtime this task was executed on.
+    stdout : str
+        Standard output for the task execution.
+    stderr : str
+        Standard error output for the task execution.
+    code : MetaflowCode
+        Code package for this task (if present). See `MetaflowCode`.
+    environment_info : Dict[str, str]
+        Information about the execution environment.
+    """
     def __init__(self, *args, **kwargs):
         ...
     @property
@@ -409,6 +458,9 @@ class CardDatastore(object, metaclass=type):
 NUM_SHORT_HASH_CHARS: int
 
 class CardClassFoundException(metaflow.exception.MetaflowException, metaclass=type):
+    """
+    This exception is raised with MetaflowCard class is not present for a particular card type.
+    """
     def __init__(self, card_name):
         ...
     ...
@@ -424,6 +476,9 @@ class UnrenderableCardException(metaflow.exception.MetaflowException, metaclass=
     ...
 
 class CardNotPresentException(metaflow.exception.MetaflowException, metaclass=type):
+    """
+    This exception is raised with a card is not present in the datastore.
+    """
     def __init__(self, pathspec, card_type = None, card_hash = None, card_id = None):
         ...
     ...
@@ -440,6 +495,9 @@ def resumed_info(task):
     ...
 
 class CardRenderInfo(tuple, metaclass=type):
+    """
+    CardRenderInfo(mode, is_implemented, data, timed_out, timeout_stack_trace)
+    """
     @staticmethod
     def __new__(_cls, mode, is_implemented, data, timed_out, timeout_stack_trace):
         """

metaflow-stubs/plugins/cards/card_client.pyi

@@ -1,16 +1,16 @@
 ##################################################################################
 #                       Auto-generated Metaflow stub file                        #
-# MF version: 2.12.22                                                            #
-# Generated on 2024-09-20T00:45:49.645393                                        #
+# MF version: 2.12.24                                                            #
+# Generated on 2024-10-04T11:37:47.011919                                        #
 ##################################################################################
 
 from __future__ import annotations
 
 import typing
 if typing.TYPE_CHECKING:
-    import metaflow.exception
     import metaflow.plugins.cards.card_client
     import metaflow
+    import metaflow.exception
 
 TYPE_CHECKING: bool
 
@@ -86,6 +86,14 @@ class IncorrectPathspecException(metaflow.exception.MetaflowException, metaclass
     ...
 
 class Card(object, metaclass=type):
+    """
+    `Card` represents an individual Metaflow Card, a single HTML file, produced by
+    the card `@card` decorator. `Card`s are contained by `CardContainer`, returned by
+    `get_cards`.
+    
+    Note that the contents of the card, an HTML file, is retrieved lazily when you call
+    `Card.get` for the first time or when the card is rendered in a notebook.
+    """
     def __init__(self, card_ds, type, path, hash, id = None, html = None, created_on = None, from_resumed = False, origin_pathspec = None):
         ...
     def get_data(self) -> typing.Optional[dict]:
@@ -137,6 +145,29 @@ class Card(object, metaclass=type):
     ...
 
 class CardContainer(object, metaclass=type):
+    """
+    `CardContainer` is an immutable list-like object, returned by `get_cards`,
+    which contains individual `Card`s.
+    
+    Notably, `CardContainer` contains a special
+    `_repr_html_` function which renders cards automatically in an output
+    cell of a notebook.
+    
+    The following operations are supported:
+    ```
+    cards = get_cards(MyTask)
+    
+    # retrieve by index
+    first_card = cards[0]
+    
+    # check length
+    if len(cards) > 1:
+        print('many cards present!')
+    
+    # iteration
+    list_of_cards = list(cards)
+    ```
+    """
     def __init__(self, card_paths, card_ds, origin_pathspec = None):
         ...
     def __len__(self):

metaflow-stubs/plugins/cards/card_creator.pyi

@@ -1,7 +1,7 @@
 ##################################################################################
 #                       Auto-generated Metaflow stub file                        #
-# MF version: 2.12.22                                                            #
-# Generated on 2024-09-20T00:45:49.680915                                        #
+# MF version: 2.12.24                                                            #
+# Generated on 2024-10-04T11:37:47.040589                                        #
 ##################################################################################
 
 from __future__ import annotations
@@ -15,6 +15,9 @@ current: metaflow.metaflow_current.Current
 ASYNC_TIMEOUT: int
 
 class CardProcessManager(object, metaclass=type):
+    """
+    This class is responsible for managing the card creation processes.
+    """
     ...
 
 class CardCreator(object, metaclass=type):

metaflow-stubs/plugins/cards/card_datastore.pyi

@@ -1,7 +1,7 @@
 ##################################################################################
 #                       Auto-generated Metaflow stub file                        #
-# MF version: 2.12.22                                                            #
-# Generated on 2024-09-20T00:45:49.682719                                        #
+# MF version: 2.12.24                                                            #
+# Generated on 2024-10-04T11:37:47.042448                                        #
 ##################################################################################
 
 from __future__ import annotations
@@ -25,6 +25,9 @@ CARD_GSROOT: None
 SKIP_CARD_DUALWRITE: bool
 
 class CardNotPresentException(metaflow.exception.MetaflowException, metaclass=type):
+    """
+    This exception is raised with a card is not present in the datastore.
+    """
     def __init__(self, pathspec, card_type = None, card_hash = None, card_id = None):
         ...
     ...
@@ -34,6 +37,9 @@ TEMP_DIR_NAME: str
 NUM_SHORT_HASH_CHARS: int
 
 class CardInfo(tuple, metaclass=type):
+    """
+    CardInfo(type, hash, id, filename)
+    """
     @staticmethod
     def __new__(_cls, type, hash, id, filename):
         """

metaflow-stubs/plugins/cards/card_decorator.pyi

@@ -1,7 +1,7 @@
 ##################################################################################
 #                       Auto-generated Metaflow stub file                        #
-# MF version: 2.12.22                                                            #
-# Generated on 2024-09-20T00:45:49.681792                                        #
+# MF version: 2.12.24                                                            #
+# Generated on 2024-10-04T11:37:47.041504                                        #
 ##################################################################################
 
 from __future__ import annotations
@@ -14,6 +14,25 @@ if typing.TYPE_CHECKING:
 current: metaflow.metaflow_current.Current
 
 class CardComponentCollector(object, metaclass=type):
+    """
+    This class helps collect `MetaflowCardComponent`s during runtime execution
+    
+    ### Usage with `current`
+    `current.card` is of type `CardComponentCollector`
+    
+    ### Main Usage TLDR
+    - [x] `current.card.append` customizes the default editable card.
+    - [x] Only one card can be default editable in a step.
+    - [x] The card class must have `ALLOW_USER_COMPONENTS=True` to be considered default editable.
+        - [x] Classes with `ALLOW_USER_COMPONENTS=False` are never default editable.
+    - [x] The user can specify an `id` argument to a card, in which case the card is editable through `current.card[id].append`.
+        - [x] A card with an id can be also default editable, if there are no other cards that are eligible to be default editable.
+    - [x] If multiple default-editable cards exist but only one card doesn't have an id, the card without an id is considered to be default editable.
+    - [x] If we can't resolve a single default editable card through the above rules, `current.card`.append calls show a warning but the call doesn't fail.
+    - [x] A card that is not default editable can be still edited through:
+        - [x] its `current.card['myid']`
+        - [x] by looking it up by its type, e.g. `current.card.get(type='pytorch')`.
+    """
     def __init__(self, logger = None, card_creator = None):
         ...
     @staticmethod
@@ -121,6 +140,37 @@ def warning_message(message, logger = None, ts = False):
     ...
 
 class CardDecorator(metaflow.decorators.StepDecorator, metaclass=type):
+    """
+    Creates a human-readable report, a Metaflow Card, after this step completes.
+    
+    Note that you may add multiple `@card` decorators in a step with different parameters.
+    
+    Parameters
+    ----------
+    type : str, default 'default'
+        Card type.
+    id : str, optional, default None
+        If multiple cards are present, use this id to identify this card.
+    options : Dict[str, Any], default {}
+        Options passed to the card. The contents depend on the card type.
+    timeout : int, default 45
+        Interrupt reporting if it takes more than this many seconds.
+    
+    MF Add To Current
+    -----------------
+    card -> metaflow.plugins.cards.component_serializer.CardComponentCollector
+        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
+        -------
+        CardComponentCollector
+            The or one of the cards attached to this step.
+    """
     def __init__(self, *args, **kwargs):
         ...
     def step_init(self, flow, graph, step_name, decorators, environment, flow_datastore, logger):

metaflow-stubs/plugins/cards/card_modules/__init__.pyi

@@ -1,7 +1,7 @@
 ##################################################################################
 #                       Auto-generated Metaflow stub file                        #
-# MF version: 2.12.22                                                            #
-# Generated on 2024-09-20T00:45:49.678192                                        #
+# MF version: 2.12.24                                                            #
+# Generated on 2024-10-04T11:37:47.037592                                        #
 ##################################################################################
 
 from __future__ import annotations
@@ -11,6 +11,32 @@ if typing.TYPE_CHECKING:
     import metaflow
 
 class MetaflowCard(object, metaclass=type):
+    """
+    Metaflow cards derive from this base class.
+    
+    Subclasses of this class are called *card types*. The desired card
+    type `T` is defined in the `@card` decorator as `@card(type=T)`.
+    
+    After a task with `@card(type=T, options=S)` finishes executing, Metaflow instantiates
+    a subclass `C` of `MetaflowCard` that has its `type` attribute set to `T`, i.e. `C.type=T`.
+    The constructor is given the options dictionary `S` that contains arbitrary
+    JSON-encodable data that is passed to the instance, parametrizing the card. The subclass
+    may override the constructor to capture and process the options.
+    
+    The subclass needs to implement a `render(task)` method that produces the card
+    contents in HTML, given the finished task that is represented by a `Task` object.
+    
+    Attributes
+    ----------
+    type : str
+        Card type string. Note that this should be a globally unique name, similar to a
+        Python package name, to avoid name clashes between different custom cards.
+    
+    Parameters
+    ----------
+    options : Dict
+        JSON-encodable dictionary containing user-definable options for the class.
+    """
     def __init__(self, options = {}, components = [], graph = None):
         ...
     def render(self, task: "metaflow.Task") -> str:

metaflow-stubs/plugins/cards/card_modules/basic.pyi

@@ -1,7 +1,7 @@
 ##################################################################################
 #                       Auto-generated Metaflow stub file                        #
-# MF version: 2.12.22                                                            #
-# Generated on 2024-09-20T00:45:49.639721                                        #
+# MF version: 2.12.24                                                            #
+# Generated on 2024-10-04T11:37:47.005932                                        #
 ##################################################################################
 
 from __future__ import annotations
@@ -9,10 +9,36 @@ from __future__ import annotations
 import typing
 if typing.TYPE_CHECKING:
     import metaflow.plugins.cards.card_modules.card
-    import metaflow.plugins.cards.card_modules.basic
     import metaflow
+    import metaflow.plugins.cards.card_modules.basic
 
 class MetaflowCard(object, metaclass=type):
+    """
+    Metaflow cards derive from this base class.
+    
+    Subclasses of this class are called *card types*. The desired card
+    type `T` is defined in the `@card` decorator as `@card(type=T)`.
+    
+    After a task with `@card(type=T, options=S)` finishes executing, Metaflow instantiates
+    a subclass `C` of `MetaflowCard` that has its `type` attribute set to `T`, i.e. `C.type=T`.
+    The constructor is given the options dictionary `S` that contains arbitrary
+    JSON-encodable data that is passed to the instance, parametrizing the card. The subclass
+    may override the constructor to capture and process the options.
+    
+    The subclass needs to implement a `render(task)` method that produces the card
+    contents in HTML, given the finished task that is represented by a `Task` object.
+    
+    Attributes
+    ----------
+    type : str
+        Card type string. Note that this should be a globally unique name, similar to a
+        Python package name, to avoid name clashes between different custom cards.
+    
+    Parameters
+    ----------
+    options : Dict
+        JSON-encodable dictionary containing user-definable options for the class.
+    """
     def __init__(self, options = {}, components = [], graph = None):
         ...
     def render(self, task: "metaflow.Task") -> str:
@@ -88,6 +114,14 @@ def read_file(path):
     ...
 
 class DefaultComponent(metaflow.plugins.cards.card_modules.card.MetaflowCardComponent, metaclass=type):
+    """
+    The `DefaultCard` and the `BlankCard` use a JS framework that build the HTML dynamically from JSON.
+    The `DefaultComponent` is the base component that helps build the JSON when `render` is called.
+    
+    The underlying JS framework consists of various types of objects.
+    These can be found in: "metaflow/plugins/cards/ui/types.ts".
+    The `type` attribute in a `DefaultComponent` corresponds to the type of component in the Javascript framework.
+    """
     def __init__(self, title = None, subtitle = None):
         ...
     def render(self):
@@ -197,6 +231,11 @@ class MarkdownComponent(DefaultComponent, metaclass=type):
     ...
 
 class TaskInfoComponent(metaflow.plugins.cards.card_modules.card.MetaflowCardComponent, metaclass=type):
+    """
+    Properties
+        page_content : a list of MetaflowCardComponents going as task info
+        final_component: the dictionary returned by the `render` function of this class.
+    """
     def __init__(self, task, page_title = "Task Info", only_repr = True, graph = None, components = [], runtime = False):
         ...
     def render(self):