Skip to content

Paths Service Errors

consortium.server.exceptions.service_exceptions.paths_service_exceptions

Exception hierarchy:

PathsServiceError(message='', detail=None)

Bases: BaseServiceError

Base exception for all errors that occur within the paths service.

Attributes:

Name Type Description
code

A stable machine-readable string identifying the specific error.

message str

A human-readable description of what went wrong and, where possible, how to resolve it.

detail dict[str, JsonValue] | None

Optional structured context about the error, or None when there is none.

code = 'PATHS_SERVICE_ERROR' class-attribute instance-attribute

ConsortiumUserAccountsFileSystemError(operation, path, underlying_error)

Bases: PathsServiceError

Raised when the paths service cannot confirm the user accounts file is present on disk as a preflight check at server startup.

This is distinct from UserAccountsFileSystemError, which the user accounts service raises when it later reads or writes the file. This error is raised earlier, during the paths service's own startup preflight, before the user accounts service ever touches the file.

code = 'CONSORTIUM_USER_ACCOUNTS_FILE_SYSTEM_ERROR' class-attribute instance-attribute

ConsortiumRolePermissionsFileSystemError(operation, path, underlying_error)

Bases: PathsServiceError

Raised when the paths service cannot confirm the role permissions file is present on disk as a preflight check at server startup.

This is distinct from RolePermissionsFileSystemError, which the authorization service raises when it later reads or writes the file. This error is raised earlier, during the paths service's own startup preflight, before the authorization service ever touches the file.

code = 'CONSORTIUM_ROLE_PERMISSIONS_FILE_SYSTEM_ERROR' class-attribute instance-attribute

ConsortiumReleaseFileSystemError(operation, path, underlying_error)

Bases: PathsServiceError

Raised when the paths service cannot confirm the release JSON file is present on disk as a preflight check at server startup.

This is distinct from ReleaseFileSystemError, which the release service raises when it later reads the file. This error is raised earlier, during the paths service's own startup preflight, before the release service ever touches the file.

code = 'CONSORTIUM_RELEASE_FILE_SYSTEM_ERROR' class-attribute instance-attribute

ConsortiumDirectoryFileSystemError(operation, path, underlying_error)

Bases: PathsServiceError

Raised when the paths service cannot confirm or create one of the directories it expects to exist, as a preflight check at server startup.

code = 'CONSORTIUM_DIRECTORY_FILE_SYSTEM_ERROR' class-attribute instance-attribute