Exceptions¶
This page documents all custom exceptions used in the social-links library. All exceptions inherit from SocialLinksError, allowing you to catch all social-links related errors with a single exception handler.
sociallinks.exceptions ¶
Custom exceptions for the sociallinks library.
This module defines all custom exceptions used throughout the social-links
library. All exceptions inherit from SocialLinksError, allowing
you to catch all social-links related errors with a single exception handler.
SocialLinksError ¶
Bases: Exception
Base exception for all social-links errors.
All custom exceptions in the social-links library inherit from this class, allowing you to catch all social-links related errors with a single exception handler.
PlatformError ¶
Bases: SocialLinksError
Base exception for platform-related errors.
This exception serves as the base class for all errors related to platform management, including platform registration, configuration, and lookup. All platform-specific errors inherit from this class.
PlatformNotFoundError ¶
Bases: PlatformError
Raised when a platform is not found.
This exception is raised when attempting to access, modify, or delete a platform that does not exist in the platform registry.
PlatformAlreadyExistsError ¶
Bases: PlatformError
Raised when attempting to create a platform that already exists.
This exception is raised when trying to register a platform with a name
that is already in use. To replace an existing platform, use the override=True
parameter with SocialLinks.set_platform or SocialLinks.set_platforms.
InvalidPlatformError ¶
Bases: PlatformError
Raised when a platform has an invalid configuration.
This exception is raised when a platform configuration is missing required
fields or has invalid structure. A valid platform entry must be a list
of dictionaries, each containing both patterns and sanitized keys.
Entries missing either field are skipped, but at least one complete entry
is required for the platform to be valid.
InvalidPlatformRegexError ¶
Bases: InvalidPlatformError
Raised when a platform defines an invalid regex pattern.
This exception is raised when a regex pattern in a platform configuration cannot be compiled, typically due to syntax errors in the pattern string.
URLParsingError ¶
Bases: SocialLinksError
Base exception for URL parsing and matching errors.
This exception serves as the base class for all errors related to URL parsing, validation, and matching operations. All URL-related errors inherit from this class.
URLMismatchError ¶
Bases: URLParsingError
Raised when a URL does not match the expected platform pattern.
This exception is raised when attempting to validate or sanitize a URL that doesn't match any of the patterns defined for the specified platform.
PlatformIDExtractionError ¶
Bases: URLParsingError
Raised when a platform identifier cannot be extracted from a URL.
This exception is raised when a URL matches a platform pattern but the platform identifier (username, ID, etc.) cannot be extracted, typically due to a missing or incorrectly named capture group in the regex pattern.