Skip to content

user

OAuthAccountRead

Bases: BaseModel

Schema for storing essential OAuthAccount information within UserRead.oauth_accounts.

Attributes:

Name Type Description
id int

ID of the row in fractal-owned oauthaccount table.
account_email str

Email associated to OAuth account
oauth_name str

Name of the OAuth provider (e.g. github)
Source code in fractal_server/app/schemas/user.py 
17
18
19
20
21
22
23
24
25
26
27
28
29
30
class OAuthAccountRead(BaseModel):
    """
    Schema for storing essential `OAuthAccount` information within
    `UserRead.oauth_accounts`.

    Attributes:
        id: ID of the row in fractal-owned `oauthaccount` table.
        account_email: Email associated to OAuth account
        oauth_name: Name of the OAuth provider (e.g. `github`)
    """

    id: int
    account_email: str
    oauth_name: str

UserCreate

Bases: BaseUserCreate

Schema for User creation.

Attributes:

Name Type Description
profile_id int | None
Source code in fractal_server/app/schemas/user.py 
 95
 96
 97
 98
 99
100
101
102
103
104
105
class UserCreate(schemas.BaseUserCreate):
    """
    Schema for `User` creation.

    Attributes:
        profile_id:
    """

    profile_id: int | None = None
    project_dir: Annotated[AbsolutePathStr, AfterValidator(_validate_cmd)]
    slurm_accounts: list[str] = Field(default_factory=list)

UserRead

Bases: BaseUser[int]

Schema for User read from database.

Attributes:

Name Type Description
group_ids_names list[tuple[int, str]] | None
oauth_accounts list[OAuthAccountRead]
profile_id int | None
Source code in fractal_server/app/schemas/user.py 
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
class UserRead(schemas.BaseUser[int]):
    """
    Schema for `User` read from database.

    Attributes:
        group_ids_names:
        oauth_accounts:
        profile_id:
    """

    group_ids_names: list[tuple[int, str]] | None = None
    oauth_accounts: list[OAuthAccountRead]
    profile_id: int | None = None
    project_dir: str
    slurm_accounts: list[str]

UserUpdate

Bases: BaseUserUpdate

Schema for User update.

Attributes:

Name Type Description
password NonEmptyStr
email EmailStr
is_active bool
is_superuser bool
is_verified bool
profile_id int | None
project_dir Annotated[AbsolutePathStr, AfterValidator(_validate_cmd)]
slurm_accounts ListUniqueNonEmptyString
Source code in fractal_server/app/schemas/user.py 
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
class UserUpdate(schemas.BaseUserUpdate):
    """
    Schema for `User` update.

    Attributes:
        password:
        email:
        is_active:
        is_superuser:
        is_verified:
        profile_id:
        project_dir:
        slurm_accounts:
    """

    model_config = ConfigDict(extra="forbid")
    password: NonEmptyStr = None
    email: EmailStr = None
    is_active: bool = None
    is_superuser: bool = None
    is_verified: bool = None
    profile_id: int | None = None
    project_dir: Annotated[
        AbsolutePathStr, AfterValidator(_validate_cmd)
    ] = None
    slurm_accounts: ListUniqueNonEmptyString = None

UserUpdateGroups

Bases: BaseModel

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

Source code in fractal_server/app/schemas/user.py 
108
109
110
111
112
113
114
115
116
class UserUpdateGroups(BaseModel):
    """
    Schema for `POST /auth/users/{user_id}/set-groups/`

    """

    model_config = ConfigDict(extra="forbid")

    group_ids: ListUniqueNonNegativeInt = Field(min_length=1)

UserUpdateStrict

Bases: BaseModel

Schema for User self-editing.

Attributes:

Name Type Description
slurm_accounts ListUniqueNonEmptyString
Source code in fractal_server/app/schemas/user.py 
83
84
85
86
87
88
89
90
91
92
class UserUpdateStrict(BaseModel):
    """
    Schema for `User` self-editing.

    Attributes:
        slurm_accounts:
    """

    model_config = ConfigDict(extra="forbid")
    slurm_accounts: ListUniqueNonEmptyString = None