UI Definition

from latch.types.metadata import LatchMetadata, LatchParameter, LatchAuthor

metadata = LatchMetadata(
    display_name="Workflow Name",
    author=LatchAuthor(
        name="Your Name",
        email="your.email@example.com",
        github="https://github.com/username"
    ),
    documentation="https://github.com/author/my_workflow/README.md",
    repository="https://github.com/author/my_workflow",
    license="MIT",
    parameters={
        'param_name': LatchParameter(
            display_name="Parameter Display Name",
            description="Parameter description",
            hidden=False,
            section_title="Section Title"
        )
    },
    tags=["NGS", "MAG"],
    flow=[...],
    no_standard_bulk_execution=False,
    about_page_path=Path("about.md")
)

from latch.types.metadata import NextflowMetadata, NextflowParameter, LatchAuthor
from latch.types.metadata import NextflowRuntimeResources

metadata = NextflowMetadata(
    display_name="Nextflow Workflow",
    author=LatchAuthor(name="Your Name"),
    parameters={
        'input_file': NextflowParameter(
            type=LatchFile,
            display_name="Input File",
            description="Input file description"
        )
    },
    runtime_resources=NextflowRuntimeResources(
        cpus=8,
        memory=16,
        storage_gib=200
    ),
    execution_profiles=["docker", "test"],
    log_dir=LatchDir("latch:///log_directory"),
    upload_command_logs=True
)

from latch.types.metadata import SnakemakeMetadata, SnakemakeParameter, LatchAuthor
from latch.types.metadata import DockerMetadata, EnvironmentConfig

metadata = SnakemakeMetadata(
    display_name="Snakemake Workflow",
    author=LatchAuthor(name="Your Name"),
    parameters={
        'samples': SnakemakeParameter(
            type=List[Sample],
            display_name="Samples",
            samplesheet=True
        )
    },
    file_metadata={
        'samples': SnakemakeFileMetadata(
            path=Path('data/samples/'),
            config=True,
            download=False
        )
    },
    output_dir=LatchDir("latch:///output_directory"),
    docker_metadata=DockerMetadata(
        username="username",
        secret_name="docker_secret"
    ),
    env_config=EnvironmentConfig(
        use_conda=True,
        use_container=False
    ),
    cores=8,
    about_page_content=Path("about.md")
)

LatchParameter(
    display_name="Parameter Name",
    description="Parameter description",
    hidden=False,
    section_title="Section Title",
    placeholder="Enter value...",
    comment="Additional comment",
    output=False,
    batch_table_column=False,
    allow_dir=True,
    allow_file=True,
    appearance_type=LatchAppearanceEnum.line,
    rules=[LatchRule(...)],
    detail="Additional detail text",
    samplesheet=False,
    allowed_tables=[1, 2, 3]
)

NextflowParameter(
    type=typing.Any,  # Required for Nextflow
    display_name="Parameter Name",
    description="Description",
    default=None,
    samplesheet=False,
    samplesheet_type='csv',
    samplesheet_constructor=custom_constructor,
    results_paths=[Path("output1"), Path("output2")]
)

SnakemakeParameter(
    type=typing.Any,  # Required for Snakemake
    display_name="Parameter Name",
    description="Description",
    default=None
)

flow=[
    Section(
        "Input Section",
        Text("Configure your input data"),
        Params("input_file", "output_dir")
    ),
    Section(
        "Processing Options",
        Text("Configure processing parameters"),
        Params("threads", "memory")
    ),
    Spoiler(
        "Advanced Options",
        Text("Advanced configuration options"),
        Params("advanced_param1", "advanced_param2")
    )
]

appearance_type=LatchAppearance(
    type=LatchAppearanceEnum.paragraph,
    placeholder="Enter detailed description...",
    comment="This field supports markdown formatting",
    detail="Additional context information"
)

Section(
    "Section Title",
    Text("Description text"),
    Params("param1", "param2"),
    Fork(...)
)

Text("This is markdown text with **bold** and *italic* formatting")

Title("# Main Title")

Params("param1", "param2", "param3")

Spoiler(
    "Advanced Options",
    Text("These are advanced configuration options"),
    Params("advanced_param1", "advanced_param2")
)

Fork(
    "sample_fork",
    "Choose read type",
    paired_end=ForkBranch("Paired-end", Params("paired_end")),
    single_end=ForkBranch("Single-end", Params("single_end"))
)

LatchAuthor(
    name="Author Name",
    email="author@example.com",
    github="https://github.com/username"
)

LatchRule(
    regex=r"\.(fastq|fq)$",
    message="Only .fastq or .fq files are allowed"
)

# Line input
appearance_type=LatchAppearanceEnum.line

# Paragraph input
appearance_type=LatchAppearanceEnum.paragraph

# Multiselect with custom options
appearance_type=Multiselect(
    options=[
        MultiselectOption("Option 1", "value1"),
        MultiselectOption("Option 2", "value2")
    ],
    allow_custom=True
)

SnakemakeFileMetadata(
    path=Path('local/path/'),
    config=True,
    download=False
)

NextflowRuntimeResources(
    cpus=8,
    memory=16,
    storage_gib=200,
    storage_expiration_hours=168  # 7 days
)

DockerMetadata(
    username="docker_username",
    secret_name="docker_password_secret"
)

EnvironmentConfig(
    use_conda=True,
    use_container=False,
    container_args=["--gpus", "all"]
)

ParameterType = Union[
    None,
    int,
    float,
    str,
    bool,
    LatchFile,
    LatchDir,
    Enum,
    _IsDataclass,  # Any dataclass
    Collection["ParameterType"],  # Lists, Dicts, etc.
]

'samples': NextflowParameter(
    type=List[Sample],
    samplesheet=True,
    samplesheet_type='csv'
)

def custom_constructor(samples: List[Sample]) -> Path:
    # Custom logic to create samplesheet
    return Path("custom_samplesheet.txt")

'samples': NextflowParameter(
    type=List[Sample],
    samplesheet=True,
    samplesheet_constructor=custom_constructor
)

from latch.types.samplesheet_item import SamplesheetItem

@dataclass
class Sample:
    fastq_1: LatchFile
    fastq_2: Optional[LatchFile]

@task
def example(input: list[SamplesheetItem[Sample]]):
    for row in input:
        print(row.data) # `Sample` object, contains the underlying data of the row
        print(row.record) # `Record` object, None if the row wasn't imported from registry

'filename': LatchParameter(
    display_name="Filename",
    rules=[
        LatchRule(
            regex=r"^[a-zA-Z0-9_-]+$",
            message="Filename must contain only letters, numbers, underscores, and hyphens"
        )
    ]
)

'email': LatchParameter(
    display_name="Email",
    rules=[
        LatchRule(
            regex=r"^[^@]+@[^@]+\.[^@]+$",
            message="Must be a valid email address"
        ),
        LatchRule(
            regex=r"^.{5,100}$",
            message="Email must be between 5 and 100 characters"
        )
    ]
)