Skip to content

Lists

Basic Usage

Create dynamic lists of any type with add/remove buttons.

from func_to_web import run
from func_to_web.types import Color, Email

def process_data(
    # Basic type lists
    numbers: list[int],                      # List of integers
    colors: list[Color],                     # List of color pickers
    names: list[str] = ["Alice", "Bob"],     # List with defaults
):
    return f"Processed {len(numbers)} numbers, {len(names)} names"

run(process_data)

Dynamic Lists

List Constraints

from func_to_web import run
from typing import Annotated
from pydantic import Field

def rate_movies(
    # Each rating 1-5, need 3-10 ratings total
    ratings: Annotated[
        list[Annotated[int, Field(ge=1, le=5)]],
        Field(min_length=3, max_length=10)
    ]
):
    avg = sum(ratings) / len(ratings)
    return f"Average rating: {avg:.1f} ⭐"

run(rate_movies)

List Constraints

File Lists

Upload multiple files from different folders easily.

from func_to_web import run
from func_to_web.types import ImageFile, DataFile

def batch_process(
    images: list[ImageFile],           # Multiple images
    datasets: list[DataFile],          # Multiple CSV/Excel files
):
    return f"Processed {len(images)} images and {len(datasets)} datasets"

run(batch_process)

Click "+" button to add more files from other folders

File Lists

Key Features

  • Dynamic add/remove buttons for each list
  • File uploads support multiple files from different folders
  • Works with all types: int, float, str, bool, date, time, Color, Email, File Types
  • Default values: list[str] = ["hello", "world"]
  • All non-optional lists require at least 1 item
  • Not supported with Literal
  • Lists cannot be nested (e.g., list[list[int]] is not supported)

Next Steps