Skip to content

User

CLASS DESCRIPTION
OAuthAccountRead

Schema for storing essential OAuthAccount information within
UserCreate

Schema for User creation.
UserProfileInfo

Attributes:
UserRead

Schema for User read from database.
UserUpdate

Schema for User update.
UserUpdateGroups

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

Schema for User self-editing.

Attributes

Classes

OAuthAccountRead pydantic-model

Bases: BaseModel

Schema for storing essential OAuthAccount information within UserRead.oauth_accounts.

ATTRIBUTE DESCRIPTION
id

ID of the row in fractal-owned oauthaccount table.

TYPE: int

account_email

Email associated to OAuth account

TYPE: str

oauth_name

Name of the OAuth provider (e.g. github)

TYPE: str

Fields:

  • id (int)
  • account_email (str)
  • oauth_name (str)
Source code in fractal_server/app/schemas/user.py 
23
24
25
26
27
28
29
30
31
32
33
34
35
36
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.

ATTRIBUTE DESCRIPTION
is_guest

TYPE: bool

profile_id

TYPE: int | None

project_dirs

TYPE: ListUniqueProjectDir

slurm_accounts

TYPE: list[str]

Source code in fractal_server/app/schemas/user.py 
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
class UserCreate(schemas.BaseUserCreate):
    """
    Schema for `User` creation.

    Attributes:
        is_guest:
        profile_id:
        project_dirs:
        slurm_accounts:
    """

    is_guest: bool = False
    profile_id: int | None = None
    project_dirs: Annotated[
        ListUniqueProjectDir, AfterValidator(_validate_cmd_list)
    ] = Field(min_length=1)
    slurm_accounts: list[str] = Field(default_factory=list)

UserProfileInfo pydantic-model

Bases: BaseModel

ATTRIBUTE DESCRIPTION
has_profile

TYPE: bool

resource_name

TYPE: str | None

profile_name

TYPE: str | None

username

TYPE: str | None

Fields:

  • has_profile (bool)
  • resource_name (str | None)
  • profile_name (str | None)
  • username (str | None)
Source code in fractal_server/app/schemas/user.py 
135
136
137
138
139
140
141
142
143
144
145
146
147
class UserProfileInfo(BaseModel):
    """
    Attributes:
        has_profile:
        resource_name:
        profile_name:
        username:
    """

    has_profile: bool
    resource_name: str | None = None
    profile_name: str | None = None
    username: str | None = None

UserRead

Bases: BaseUser[int]

Schema for User read from database.

ATTRIBUTE DESCRIPTION
is_guest

TYPE: bool

group_ids_names

TYPE: list[tuple[int, str]] | None

oauth_accounts

TYPE: list[OAuthAccountRead]

profile_id

TYPE: int | None

project_dirs

TYPE: list[str]

slurm_accounts

TYPE: list[str]

Source code in fractal_server/app/schemas/user.py 
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
class UserRead(schemas.BaseUser[int]):
    """
    Schema for `User` read from database.

    Attributes:
        is_guest:
        group_ids_names:
        oauth_accounts:
        profile_id:
        project_dirs:
        slurm_accounts:

    """

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

UserUpdate

Bases: BaseUserUpdate

Schema for User update.

ATTRIBUTE DESCRIPTION
password

TYPE: NonEmptyStr

email

TYPE: EmailStr

is_active

TYPE: bool

is_superuser

TYPE: bool

is_verified

TYPE: bool

is_guest

TYPE: bool

profile_id

TYPE: int | None

project_dirs

TYPE: ListUniqueProjectDir

slurm_accounts

TYPE: ListUniqueNonEmptyString

Source code in fractal_server/app/schemas/user.py 
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
class UserUpdate(schemas.BaseUserUpdate):
    """
    Schema for `User` update.

    Attributes:
        password:
        email:
        is_active:
        is_superuser:
        is_verified:
        is_guest:
        profile_id:
        project_dirs:
        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
    is_guest: bool = None
    profile_id: int | None = None
    project_dirs: Annotated[
        ListUniqueProjectDir, AfterValidator(_validate_cmd_list)
    ] = Field(default=None, min_length=1)
    slurm_accounts: ListUniqueNonEmptyString = None

UserUpdateGroups pydantic-model

Bases: BaseModel

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

ATTRIBUTE DESCRIPTION
group_ids

TYPE: ListUniqueNonNegativeInt

Config:

  • extra: forbid

Fields:

Source code in fractal_server/app/schemas/user.py 
122
123
124
125
126
127
128
129
130
131
132
class UserUpdateGroups(BaseModel):
    """
    Schema for `POST /auth/users/{user_id}/set-groups/`

    Attributes:
        group_ids:
    """

    model_config = ConfigDict(extra="forbid")

    group_ids: ListUniqueNonNegativeInt = Field(min_length=1)

UserUpdateStrict pydantic-model

Bases: BaseModel

Schema for User self-editing.

ATTRIBUTE DESCRIPTION
slurm_accounts

TYPE: ListUniqueNonEmptyString

Config:

  • extra: forbid

Fields:

Source code in fractal_server/app/schemas/user.py 
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
class UserUpdateStrict(BaseModel):
    """
    Schema for `User` self-editing.

    Attributes:
        slurm_accounts:
    """

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

Functions: