Skip to content

social_network

available_social_networks = get_args(SocialNetworkName.__value__) module-attribute

url_dictionary = {'LinkedIn': 'https://linkedin.com/in/', 'GitHub': 'https://github.com/', 'GitLab': 'https://gitlab.com/', 'IMDB': 'https://imdb.com/name/', 'Instagram': 'https://instagram.com/', 'ORCID': 'https://orcid.org/', 'StackOverflow': 'https://stackoverflow.com/users/', 'ResearchGate': 'https://researchgate.net/profile/', 'YouTube': 'https://youtube.com/@', 'Google Scholar': 'https://scholar.google.com/citations?user=', 'Telegram': 'https://t.me/', 'WhatsApp': 'https://wa.me/', 'Leetcode': 'https://leetcode.com/u/', 'X': 'https://x.com/', 'Bluesky': 'https://bsky.app/profile/', 'Reddit': 'https://reddit.com/user/'} module-attribute

url_validator = pydantic.TypeAdapter[pydantic.HttpUrl](pydantic.HttpUrl) module-attribute

SocialNetworkName = Literal['LinkedIn', 'GitHub', 'GitLab', 'IMDB', 'Instagram', 'ORCID', 'Mastodon', 'StackOverflow', 'ResearchGate', 'YouTube', 'Google Scholar', 'Telegram', 'WhatsApp', 'Leetcode', 'X', 'Bluesky', 'Reddit']

SocialNetwork

Bases: BaseModelWithoutExtraKeys

model_config = pydantic.ConfigDict(extra='forbid', validate_default=True) class-attribute instance-attribute

network = pydantic.Field() class-attribute instance-attribute

url cached property

Generate profile URL from network and username.

Why

Users provide network+username for brevity. Property generates full URLs with platform-specific logic (e.g., Mastodon domain extraction).

Returns:

  • str –

    Complete profile URL.

username = pydantic.Field(examples=['john_doe', '@johndoe@mastodon.social', '12345/john-doe']) class-attribute instance-attribute

check_username(username, info) classmethod

Validate username format per network's requirements.

Why

Different platforms have specific username formats (e.g., Mastodon needs @user@domain, StackOverflow needs id/name). Early validation prevents broken URL generation.

Parameters:

  • username (str) –

    Username to validate.

  • info (ValidationInfo) –

    Validation context containing network field.

Returns:

  • str –

    Validated username.

Source code in src/rendercv/schema/models/cv/social_network.py 
 59
 60
 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
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
@pydantic.field_validator("username")
@classmethod
def check_username(cls, username: str, info: pydantic.ValidationInfo) -> str:
    """Validate username format per network's requirements.

    Why:
        Different platforms have specific username formats (e.g., Mastodon needs
        @user@domain, StackOverflow needs id/name). Early validation prevents
        broken URL generation.

    Args:
        username: Username to validate.
        info: Validation context containing network field.

    Returns:
        Validated username.
    """
    if "network" not in info.data:
        # the network is either not provided or not one of the available social
        # networks. In this case, don't check the username, since Pydantic will
        # raise an error for the network.
        return username

    network = info.data["network"]

    match network:
        case "Mastodon":
            mastodon_username_pattern = r"@[^@]+@[^@]+"
            if not re.fullmatch(mastodon_username_pattern, username):
                raise pydantic_core.PydanticCustomError(
                    CustomPydanticErrorTypes.other.value,
                    'Mastodon username should be in the format "@username@domain".',
                )
        case "StackOverflow":
            stackoverflow_username_pattern = r"\d+\/[^\/]+"
            if not re.fullmatch(stackoverflow_username_pattern, username):
                raise pydantic_core.PydanticCustomError(
                    CustomPydanticErrorTypes.other.value,
                    "StackOverflow username should be in the format"
                    ' "user_id/username".',
                )
        case "YouTube":
            if username.startswith("@"):
                raise pydantic_core.PydanticCustomError(
                    CustomPydanticErrorTypes.other.value,
                    'YouTube username should not start with "@". Remove "@" from'
                    ' the beginning of the username."',
                )
        case "ORCID":
            orcid_username_pattern = r"\d{4}-\d{4}-\d{4}-\d{3}[\dX]"
            if not re.fullmatch(orcid_username_pattern, username):
                raise pydantic_core.PydanticCustomError(
                    CustomPydanticErrorTypes.other.value,
                    "ORCID username should be in the format 'XXXX-XXXX-XXXX-XXX'.",
                )
        case "IMDB":
            imdb_username_pattern = r"nm\d{7}"
            if not re.fullmatch(imdb_username_pattern, username):
                raise pydantic_core.PydanticCustomError(
                    CustomPydanticErrorTypes.other.value,
                    "IMDB name should be in the format 'nmXXXXXXX'.",
                )
        case "Bluesky":
            bluesky_username_pattern = r"^([a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\.)+[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?$"
            if not re.fullmatch(bluesky_username_pattern, username):
                raise pydantic_core.PydanticCustomError(
                    CustomPydanticErrorTypes.other.value,
                    "Bluesky username should be a valid handle with no '@' (e.g.,"
                    " 'username.bsky.social' or 'domain.com').",
                )
        case "WhatsApp":
            phone_validator = pydantic.TypeAdapter[
                pydantic_phone_numbers.PhoneNumber
            ](pydantic_phone_numbers.PhoneNumber)
            try:
                phone_validator.validate_python(username)
            except pydantic.ValidationError as e:
                raise pydantic_core.PydanticCustomError(
                    CustomPydanticErrorTypes.other.value,
                    "WhatsApp username should be your phone number with country"
                    " code in international format (e.g., +1 for USA, +44 for UK).",
                ) from e
        case "Reddit":
            reddit_username_pattern = r"^[a-zA-Z0-9_-]{3,23}$"
            if not re.fullmatch(reddit_username_pattern, username):
                raise pydantic_core.PydanticCustomError(
                    CustomPydanticErrorTypes.other.value,
                    "Reddit username should be made up of uppercase/lowercase"
                    " letters, numbers, underscores, and hyphens between 3 and 23"
                    " characters.",
                )

    return username

validate_generated_url()

Validate generated URL is well-formed.

Why

URL generation from username might produce invalid URLs if username format is wrong. Post-validation check catches edge cases.

Returns:

Source code in src/rendercv/schema/models/cv/social_network.py 
153
154
155
156
157
158
159
160
161
162
163
164
165
@pydantic.model_validator(mode="after")
def validate_generated_url(self) -> "SocialNetwork":
    """Validate generated URL is well-formed.

    Why:
        URL generation from username might produce invalid URLs if username
        format is wrong. Post-validation check catches edge cases.

    Returns:
        Validated social network instance.
    """
    url_validator.validate_strings(self.url)
    return self