schemas

UserCreate

Bases: BaseUserCreate

Schema for User creation.

Attributes:

Name	Type	Description
username	Optional[str]

Source code in fractal_server/app/schemas/user.py

class UserCreate(schemas.BaseUserCreate):
    """
    Schema for `User` creation.

    Attributes:
        username:
    """

    username: Optional[str] = None

    # Validators

    _username = field_validator("username")(classmethod(valstr("username")))

UserGroupCreate

Bases: BaseModel

Schema for UserGroup creation

Attributes:

Name	Type	Description
name	str	Group name

Source code in fractal_server/app/schemas/user_group.py

class UserGroupCreate(BaseModel):
    """
    Schema for `UserGroup` creation

    Attributes:
        name: Group name
    """

    model_config = ConfigDict(extra="forbid")

    name: str
    viewer_paths: list[str] = Field(default_factory=list)

    @field_validator("viewer_paths")
    @classmethod
    def viewer_paths_validator(cls, value):
        for i, path in enumerate(value):
            value[i] = val_absolute_path(f"viewer_paths[{i}]")(cls, path)
        value = val_unique_list("viewer_paths")(cls, value)
        return value

UserGroupRead

Bases: BaseModel

Schema for UserGroup read

NOTE: user_ids does not correspond to a column of the UserGroup table, but it is rather computed dynamically in relevant endpoints.

Attributes:

Name	Type	Description
id	int	Group ID
name	str	Group name
timestamp_created	AwareDatetime	Creation timestamp
user_ids	Optional[list[int]]	IDs of users of this group

Source code in fractal_server/app/schemas/user_group.py

class UserGroupRead(BaseModel):
    """
    Schema for `UserGroup` read

    NOTE: `user_ids` does not correspond to a column of the `UserGroup` table,
    but it is rather computed dynamically in relevant endpoints.

    Attributes:
        id: Group ID
        name: Group name
        timestamp_created: Creation timestamp
        user_ids: IDs of users of this group
    """

    id: int
    name: str
    timestamp_created: AwareDatetime
    user_ids: Optional[list[int]] = None
    viewer_paths: list[str]

    @field_serializer("timestamp_created")
    def serialize_datetime(v: datetime) -> str:
        return v.isoformat()

UserGroupUpdate

Bases: BaseModel

Schema for UserGroup update

Source code in fractal_server/app/schemas/user_group.py

class UserGroupUpdate(BaseModel):
    """
    Schema for `UserGroup` update
    """

    model_config = ConfigDict(extra="forbid")

    viewer_paths: Optional[list[str]] = None

    @field_validator("viewer_paths")
    @classmethod
    def viewer_paths_validator(cls, value):
        if value is None:
            raise ValueError("Cannot set `viewer_paths=None`.")
        for i, path in enumerate(value):
            value[i] = val_absolute_path(f"viewer_paths[{i}]")(cls, path)
        value = val_unique_list("viewer_paths")(cls, value)
        return value

UserRead

Bases: BaseUser[int]

Schema for User read from database.

Attributes:

Name	Type	Description
username	Optional[str]

Source code in fractal_server/app/schemas/user.py

class UserRead(schemas.BaseUser[int]):
    """
    Schema for `User` read from database.

    Attributes:
        username:
    """

    username: Optional[str] = None
    group_ids_names: Optional[list[tuple[int, str]]] = None
    oauth_accounts: list[OAuthAccountRead]

UserSettingsRead

Bases: BaseModel

Schema reserved for superusers

Source code in fractal_server/app/schemas/user_settings.py

class UserSettingsRead(BaseModel):
    """
    Schema reserved for superusers
    """

    id: int
    ssh_host: Optional[str] = None
    ssh_username: Optional[str] = None
    ssh_private_key_path: Optional[str] = None
    ssh_tasks_dir: Optional[str] = None
    ssh_jobs_dir: Optional[str] = None
    slurm_user: Optional[str] = None
    slurm_accounts: list[str]
    project_dir: Optional[str] = None

UserSettingsUpdate

Bases: BaseModel

Schema reserved for superusers

Source code in fractal_server/app/schemas/user_settings.py

class UserSettingsUpdate(BaseModel):
    """
    Schema reserved for superusers
    """

    model_config = ConfigDict(extra="forbid")

    ssh_host: Optional[str] = None
    ssh_username: Optional[str] = None
    ssh_private_key_path: Optional[str] = None
    ssh_tasks_dir: Optional[str] = None
    ssh_jobs_dir: Optional[str] = None
    slurm_user: Optional[str] = None
    slurm_accounts: Optional[list[StrictStr]] = None
    project_dir: Optional[str] = None

    _ssh_host = field_validator("ssh_host")(
        classmethod(valstr("ssh_host", accept_none=True))
    )
    _ssh_username = field_validator("ssh_username")(
        classmethod(valstr("ssh_username", accept_none=True))
    )
    _ssh_private_key_path = field_validator("ssh_private_key_path")(
        classmethod(
            val_absolute_path("ssh_private_key_path", accept_none=True)
        )
    )

    _ssh_tasks_dir = field_validator("ssh_tasks_dir")(
        classmethod(val_absolute_path("ssh_tasks_dir", accept_none=True))
    )
    _ssh_jobs_dir = field_validator("ssh_jobs_dir")(
        classmethod(val_absolute_path("ssh_jobs_dir", accept_none=True))
    )

    _slurm_user = field_validator("slurm_user")(
        classmethod(valstr("slurm_user", accept_none=True))
    )

    @field_validator("slurm_accounts")
    @classmethod
    def slurm_accounts_validator(cls, value):
        if value is None:
            return value
        for i, item in enumerate(value):
            value[i] = valstr(f"slurm_accounts[{i}]")(cls, item)
        return val_unique_list("slurm_accounts")(cls, value)

    @field_validator("project_dir")
    @classmethod
    def project_dir_validator(cls, value):
        if value is None:
            return None
        validate_cmd(value)
        return val_absolute_path("project_dir")(cls, value)

UserUpdate

Bases: BaseUserUpdate

Schema for User update.

Attributes:

Name	Type	Description
username	Optional[str]

Source code in fractal_server/app/schemas/user.py

class UserUpdate(schemas.BaseUserUpdate):
    """
    Schema for `User` update.

    Attributes:
        username:
    """

    model_config = ConfigDict(extra="forbid")

    username: Optional[str] = None

    # Validators
    _username = field_validator("username")(classmethod(valstr("username")))

    @field_validator(
        "is_active",
        "is_verified",
        "is_superuser",
        "email",
        "password",
    )
    @classmethod
    def cant_set_none(cls, v, info: ValidationInfo):
        if v is None:
            raise ValueError(f"Cannot set {info.field_name}=None")
        return v

UserUpdateGroups

Bases: BaseModel

Schema for POST /auth/users/{user_id}/set-groups/

Source code in fractal_server/app/schemas/user.py

class UserUpdateGroups(BaseModel):
    """
    Schema for `POST /auth/users/{user_id}/set-groups/`

    """

    model_config = ConfigDict(extra="forbid")

    group_ids: list[int] = Field(min_length=1)

    _group_ids = field_validator("group_ids")(
        classmethod(val_unique_list("group_ids"))
    )