UncountablePythonSDK 0.0.24__py3-none-any.whl → 0.0.131__py3-none-any.whl

type_spec/external/api/recipes/get_recipes_data.yaml

@@ -1,244 +0,0 @@
-$endpoint:
-    is_sdk: true
-    method: get
-    path: ${external}/recipes/external_get_recipes_data
-    function: main.site.app.external.recipes.get_recipes_data.get_recipes_data
-    desc: "Gets all data associated with a set of recipes. Because Uncountables recipe structure is complex, various data values are exploded out to increase efficiency in parsing, and this page is paginated to prevent too large of return values"
-Arguments:
-    type: Object
-    properties:
-        recipe_ids?:
-            type: Optional<List<ObjectId>>
-            desc: "The recipes to get the data from. Either these or project_id must be filled in"
-        project_id?:
-            type: Optional<ObjectId>
-            desc: "The projects to get the data from. Either these or recipe_ids must be filled in"
-        offset?:
-            type: Optional<Integer>
-            desc: "Used for pagination. All pagination is done in order of Recipe ID"
-        limit?:
-            type: Optional<Integer>
-            desc: "The number of data points to return. If not filled in, it will be set to 100, and cannot be set higher than 100"
-
-RecipeOutput:
-    type: Object
-    desc: "A representation of a single measurement associated with a recipe within Uncountable system"
-    properties:
-        id:
-            type: ObjectId
-            desc: "The global unique identifier for the recipe output. For cross-reference elsewhere."
-        output_id:
-            type: ObjectId
-            desc: "The output specifically measured in this case"
-        replicate_num:
-            type: Integer
-            desc: "The replicate number (1-indexed) of the output in question within the recipe. (Output, Output condition, Replicate_Num) form a unique index"
-        quantity_dec:
-            type: Decimal
-            desc: "The quantity of the output, if numeric or ordinal"
-        quantity_json:
-            type: JsonValue
-            desc: "The quantity of the output, if not numeric"
-        curve_id:
-            type: ObjectId
-            desc: "The id of the curve associated with the output if the output is of curve type."
-        output_condition_id:
-            type: ObjectId
-            desc: "A reference to the condition ID for the output (null if there are no conditions). Used to encode complicated test settings such as test standard, aging time, etc."
-
-ConditionParameterValue:
-    type: Object
-    desc: "A condition parameter value represents a single association of value with a parameter. For instance, Test Method: ISO 23"
-    properties:
-        condition_parameter_id:
-            type: ObjectId
-            desc: "The globally unique identifier for the condition parameter, i.e. Test Method or Aging Time"
-        condition_parameter_name:
-            type: String
-            desc: "The name of the condition parameter"
-        quantity_dec:
-            type: Decimal
-            desc: "The quantity associated with the parameter if the parameter is of numeric type. If this is filled in, quantity_json will be null"
-        quantity_json:
-            type: JsonValue
-            desc: "The quantity associated with the parameter if the parameter is not of numeric type. If this is filled in, quantity_json will not be null"
-
-SimpleOutputCondition:
-    type: Object
-    desc: "Within Uncountable, Output conditions represent how an output is measured. Common use cases include the test temperature, test standard, aging time, etc. An outputcondition is the full description of these parameters"
-    properties:
-        output_condition_id:
-            type: ObjectId
-            desc: "The globally unique ID for the Output Condition, used for cross reference elsewhere"
-        condition_parameter_values:
-            type: List<ConditionParameterValue>
-            desc: "The list of parameters and values that comprise this condition"
-
-RecipeInput:
-    type: Object
-    properties:
-        id:
-            type: ObjectId
-            desc: "The globally unique id for the recipe input"
-        input_id:
-            type: ObjectId
-            desc: "The globally unique ID for the input, allowing for cross reference elsewhere"
-        input_lot_recipe_id:
-            type: Optional<ObjectId>
-            desc: "The recipe id of the lot associated with the input"
-        recipe_step_id:
-            type: ObjectId
-            desc: "The unique Recipe Step ID for the input, allowing for placement within the workflow"
-        quantity_dec:
-            type: Decimal
-            desc: "The quantity of the input if it is numeric or recipe type. If this is filled in, quantity_json will not be filled in"
-        quantity_json:
-            type: JsonValue
-            desc: "The quantity of the input if it is not numeric or recipe type. If this is filled in, quantity_dec will not be filled in"
-        curve_id:
-            type: Optional<ObjectId>
-            desc: "The id of the curve associated with the input if the input is of curve type."
-        actual_quantity_dec:
-            type: Decimal
-            desc: "The actual quantity of the input if it is numeric or recipe type. If this is filled in, actual_quantity_json will not be filled in"
-        actual_quantity_json:
-            type: JsonValue
-            desc: "The actual quantity of the input if it is not numeric or recipe type. If this is filled in, actual_quantity_dec will not be filled in"
-        input_type:
-            type: String
-            desc: "The type of the input on the platform, for example process parameter, equipment or ingredient."
-        behavior:
-            type: String
-            desc: "The behavior of the input relative to the experiment. For example 'inclusion' or 'use quantity'."
-
-RecipeStep:
-    type: Object
-    properties:
-        name:
-            type: Optional<String>
-            desc: "An optional name for the recipe step"
-        recipe_step_id:
-            type: ObjectId
-            desc: "An ID value for the recipe step, used elsewhere to reference the part of the recipe that the input was placed in"
-        recipe_step_number:
-            type: Integer
-            desc: "An ordering for the recipe step, allowing the user to determine the ordering of the steps"
-        instructions?:
-            type: String
-            desc: "Instructions associated with the recipe step"
-
-RecipeStepGroup:
-    type: Object
-    properties:
-        name:
-            type: Optional<String>
-            desc: "An optional name for the recipe step group. These names are on a per recipe basis, allowing users to individually name sub-components of recipes"
-        recipe_steps:
-            type: List<RecipeStep>
-            desc: "A listing of recipe steps. Recipe Steps are the base component in Uncountable's recipe structure, where inputs are directly placed"
-
-RecipeWorkflowStep:
-    type: Object
-    desc: "A workflow step associated with a recipe. Workflow steps are comprised of recipe step groups, in turn comprised of recipe steps, where inputs are located. These groupings exists to give customers the ability to flexibly place inputs into the correct process ordering"
-    properties:
-        recipe_workflow_step_id:
-            type: ObjectId
-            desc: "A unique reference for the workflow step within the recipe."
-        workflow_step_id:
-            type: ObjectId
-            desc: "A reference to the workflow_step_id for the workflow. This will be shared across recipes, and can be used to do analysis about what part of a generic process inputs are located in."
-        recipe_step_groups:
-            type: List<RecipeStepGroup>
-            desc: "A listing of recipe step groups within the recipe"
-
-RecipeStepRelationship:
-    type: Object
-    properties:
-        step_relationship_id:
-            type: ObjectId
-            desc: "The unique ID for the relationship"
-        name:
-            type: Optional<String>
-            desc: "The name of this relationship"
-        quantity_dec?:
-            type: Decimal
-            desc: "The current quantity for the relationship"
-        actual_quantity_dec?:
-            type: Decimal
-            desc: "The current actual quantity for the relationship"
-        source_recipe_workflow_step_id:
-            type: ObjectId
-            desc: "The ID of the workflow step used as the source of this preceding step."
-        target_recipe_step_id:
-            type: ObjectId
-            desc: "The ID of the recipe step used as the target of this preceding step."
-
-Recipe:
-    type: Object
-    properties:
-        recipe_id:
-            type: ObjectId
-            desc: "A unique identifier for the recipe. Used for joining elsewhere"
-        creating_user_id?:
-            type: ObjectId
-            desc: "The user ID who originally created the recipe. Null when created from automated scripts, such as data transfers, or from the Uncountable implementation team."
-        create_datetime:
-            type: String
-            desc: "When the recipe was created"
-        last_modified_datetime:
-            type: String
-            desc: "when the recipe was last modified"
-        name:
-            type: String
-            desc: "The full name in the system of the recipe"
-        notes:
-            type: Optional<String>
-            desc: "Any notes associated with the recipe. This may be null if there are no notes present"
-        barcode_value?:
-            type: String
-            desc: "The value used in the barcoding system to lookup this experiment."
-        workflow_id:
-            type: ObjectId
-            desc: "The workflow ID associated with the recipe. Workflows correspond to a set of experimental steps performed, and are referenced in the workflows return object"
-        metadata:
-            type: List<recipe_metadata.RecipeMetadata>
-            desc: "Metadata associated with a recipe. Metadata includes values that are neither ingredients nor process parameters, such as a location of an experiment"
-        inputs:
-            type: List<RecipeInput>
-            desc: "Inputs and quantities of those inputs associated with a recipe. Uncountable refers to inputs as either ingredients or process parameters."
-        outputs:
-            type: List<RecipeOutput>
-            desc: "Outputs and quantities of those outputs associated with a recipe. These can be of any form referred to in the Uncountable system."
-        workflow_steps:
-            type: List<RecipeWorkflowStep>
-            desc: "A reference of workflow steps in the recipe. This is used to reference input values to where they occurred in the experimental process."
-        tag_ids:
-            type: List<ObjectId>
-            desc: A list of Tag IDs associated with the recipe
-        experiment_group_ids:
-            type: List<ObjectId>
-            desc: A list of experiment group IDs associated with the recipe
-        step_relationships:
-            type: List<RecipeStepRelationship>
-
-Data:
-    type: Object
-    properties:
-        recipes:
-            type: List<Recipe>
-        workflows:
-            type: List<workflows.SimpleWorkflow>
-        metadata:
-            type: List<recipe_metadata.SimpleRecipeMetadataField>
-        inputs:
-            type: List<inputs.SimpleInput>
-        outputs:
-            type: List<outputs.SimpleOutput>
-        output_conditions:
-            type: List<SimpleOutputCondition>
-        users:
-            type: List<users.SimpleUser>
-        recipe_tags:
-            type: List<recipe_tags.SimpleRecipeTag>
-        experiment_groups:
-            type: List<experiment_groups.SimpleExperimentGroup>

type_spec/external/api/recipes/set_recipe_inputs.yaml

@@ -1,42 +0,0 @@
-$endpoint:
-    is_sdk: true
-    method: post
-    path: ${external}/recipes/external_set_recipe_inputs
-    function: main.site.app.external.recipes.set_recipe_inputs.set_recipe_inputs
-    desc: "Sets inputs values for an experiment. Values set can be numeric, text or categorical types in the Uncountable system"
-
-RecipeInputValue:
-    type: Object
-    properties:
-        recipe_id:
-            type: ObjectId
-            desc: "A unique identifier for the recipe / experiment. Used for joining elsewhere"
-        recipe_step_id?:
-            type: Optional<ObjectId>
-            desc: "Optionally the step id for the step of the recipe to be written to. If none is passed, the input will be written to first recipe workflow step"
-        input_id:
-            type: ObjectId
-            desc: "A unique identifier for the input. Used for joining and identification"
-        value_numeric?:
-            type: Decimal
-            desc: "The numeric value for the output. Should be none if output is not of type numeric."
-        value_str?:
-            type: String
-        set_actual_value?:
-            type: Boolean
-            desc: "If True, modify the actual value for the input. If not provided or False, modify the set value for the input."
-        lot_recipe_id?:
-            type: ObjectId
-            desc: The recipe id for a lot to be associated to this recipe input. If the recipe is not a lot, it will be created as a lot.
-        remove?:
-            type: Boolean
-            desc: When true will remove the input from the recipe
-
-Arguments:
-    type: Object
-    properties:
-        input_data:
-            type: List<RecipeInputValue>
-            desc: "The inputs to set. Must be at most 100 entries long"
-Data:
-    type: Object

type_spec/external/api/recipes/set_recipe_metadata.yaml

@@ -1,20 +0,0 @@
-$endpoint:
-    is_sdk: true
-    async_batch_path: set_recipe_metadata
-    method: post
-    path: ${external}/recipes/set_recipe_metadata
-    function: main.site.app.external.recipes.set_recipe_metadata.set_recipe_metadata
-    desc: "Set metadata values on a recipe"
-
-Arguments:
-    type: Object
-    properties:
-        recipe_key:
-            type: identifier.IdentifierKey
-            desc: "Identifier for the recipe"
-        recipe_metadata:
-            type: List<recipe_metadata.MetadataValue>
-            desc: "Metadata values to populate the recipe with"
-
-Data:
-  type: Object

type_spec/external/api/recipes/set_recipe_outputs.yaml

@@ -1,52 +0,0 @@
-$endpoint:
-    is_sdk: true
-    method: post
-    path: ${external}/recipes/external_set_recipe_outputs
-    function: main.site.app.external.recipes.set_recipe_outputs.set_recipe_outputs
-    desc: "Sets output values for an experiment. Values set can be numeric, text or categorical types in the Uncountable system"
-
-CurveValues:
-    type: Object
-    properties:
-        x_values:
-            type: List<Optional<LossyDecimal>>
-            desc: List of x values for the curve
-        y_values:
-            type: List<Optional<LossyDecimal>>
-            desc: List of y or response values for the curve
-
-RecipeOutputValue:
-    type: Object
-    properties:
-        recipe_id:
-            type: ObjectId
-            desc: "A unique identifier for the recipe / experiment. Used for joining elsewhere"
-        output_id:
-            type: ObjectId
-            desc: "A unique identifier for the output. Used for joining and identification"
-        condition_id?:
-            type: ObjectId
-            desc: "A unique identifier the set of condition parameters associated with the output."
-        experiment_num:
-            type: Integer
-            desc: "The experiment number for the output in the experiment. 1 Indexed"
-        value_numeric?:
-            type: Decimal
-            desc: "The numeric value for the output. Should be none if output is not of type numeric."
-        value_str?:
-            type: String
-            desc: "A string value for the output. Should be none if output is not of type string or categorical."
-        value_curve?:
-            type: CurveValues
-            desc: "The values for the curve in two lists"
-
-Arguments:
-    type: Object
-    properties:
-        output_data:
-            type: List<RecipeOutputValue>
-            desc: "The outputs to set. Must be at most 100 entries long"
-
-Data:
-    type: response.Response
-    properties:

type_spec/external/api/recipes/set_recipe_tags.yaml

@@ -1,62 +0,0 @@
-$endpoint:
-    is_sdk: true
-    method: post
-    path: ${external}/recipes/set_recipe_tags
-    function: main.site.app.external.recipes.set_recipe_tags.set_recipe_tags
-    desc: Modifies recipes tags for a recipe
-
-RecipeTagUpdateType:
-    type: StringEnum
-    values:
-        - append
-        - override
-        - remove
-
-RecipeTagUpdateBase:
-    type: Object
-    properties:
-        type:
-            type: RecipeTagUpdateType
-
-RecipeTagAppend:
-    type: RecipeTagUpdateBase
-    properties:
-        type:
-            type: Literal<RecipeTagUpdateType.append>
-        recipe_tag_ids:
-            type: List<ObjectId>
-
-RecipeTagRemove:
-    type: RecipeTagUpdateBase
-    properties:
-        type:
-            type: Literal<RecipeTagUpdateType.remove>
-        recipe_tag_ids:
-            type: List<ObjectId>
-
-RecipeTagOverride:
-    type: RecipeTagUpdateBase
-    properties:
-        type:
-            type: Literal<RecipeTagUpdateType.override>
-        recipe_tag_ids:
-            type: List<ObjectId>
-
-
-RecipeTagUpdate:
-    type: Alias
-    alias: Union<RecipeTagAppend, RecipeTagRemove, RecipeTagOverride>
-
-
-Arguments:
-    type: Object
-    properties:
-        recipe_key:
-            type: identifier.IdentifierKey
-            desc: Identifier for the recipe
-        recipe_tag_update:
-            type: RecipeTagUpdate
-            desc: The update to perform on the recipe tags
-
-Data:
-  type: Object

type_spec/external/api/triggers/run_trigger.yaml

@@ -1,18 +0,0 @@
-$endpoint:
-    is_sdk: true
-    method: post
-    path: ${external}/triggers/run_trigger
-    function: main.site.app.external.triggers.run_trigger.run_trigger
-    desc: "Runs a trigger.  Requires admin access"
-
-Arguments:
-    type: Object
-    properties:
-        entity?:
-            type: entity.Entity
-        trigger_ref_name:
-            type: String
-
-Data:
-    type: response.Response
-    properties:

uncountable/integration/types.py

@@ -1,89 +0,0 @@
-# TODO: move to type spec
-
-
-from dataclasses import dataclass
-from enum import StrEnum
-from typing import Literal
-
-
-class JobDefinitionType(StrEnum):
-    CRON = "cron"
-    # also imagine other job types like webhook-triggered or sftp-triggered,
-    # manual, etc
-
-
-class JobExecutorType(StrEnum):
-    SCRIPT = "script"
-    # also imagine builtin executors like 'sftp_sync'
-
-
-class AuthRetrievalType(StrEnum):
-    ENV = "env"
-    # also imagine secrets manager, keyvault, etc
-
-
-@dataclass
-class JobExecutorBase:
-    type: JobExecutorType
-
-
-@dataclass
-class JobExecutorScript(JobExecutorBase):
-    type: Literal[JobExecutorType.SCRIPT]
-    import_path: str
-
-
-JobExecutor = JobExecutorScript
-
-
-@dataclass
-class JobDefinitionBase:
-    id: str
-    name: str
-
-
-@dataclass
-class CronJobDefinition(JobDefinitionBase):
-    type: Literal[JobDefinitionType.CRON]
-    cron_spec: str
-    # Here we assert that the executor has to be a script, but we could add
-    # other builtin executor types that cron jobs can support later
-    executor: JobExecutorScript
-
-
-JobDefinition = CronJobDefinition
-
-
-@dataclass
-class AuthRetrievalBase:
-    type: AuthRetrievalType
-
-
-@dataclass
-class AuthRetrievalEnv:
-    # We don't really need any extra info here, we can enforce that the auth
-    # keys are named like UNC_PROFILE_{profile name}_API_SECRET_KEY. For
-    # supporting pulling secrets from secrets manager etc it will be nice to
-    # use dataclass properties to get the secret name, region etc.
-    type: Literal[AuthRetrievalType.ENV]
-
-
-AuthRetrieval = AuthRetrievalEnv
-
-
-@dataclass
-class ProfileDefinition:
-    # profile name (expected to be something like customer_name) will be
-    # obtained from the folder name instead of specified here. Forces jobs to
-    # be organized nicely in folders that separate their identities.
-    auth_retrieval: AuthRetrieval
-    base_url: str
-    jobs: list[JobDefinition]
-
-
-@dataclass
-class ProfileMetadata:
-    # supplied by inspecting the folder name that the profile is in
-    name: str
-    base_url: str
-    auth_retrieval: AuthRetrieval