Exceptions

Custom exceptions and error handling for YouTrack CLI.

exception youtrack_cli.exceptions.YouTrackError(message: str, suggestion: str | None = None)[source]

Bases: Exception

Base exception for YouTrack CLI errors.

Parameters:

  • message (str)

  • suggestion (str | None)

__init__(message: str, suggestion: str | None = None)[source]
Parameters:

  • message (str)

  • suggestion (str | None)

exception youtrack_cli.exceptions.AuthenticationError(message: str = 'Authentication failed')[source]

Bases: YouTrackError

Authentication related errors.

Parameters:

message (str)

__init__(message: str = 'Authentication failed')[source]
Parameters:

message (str)

exception youtrack_cli.exceptions.ConnectionError(message: str = 'Failed to connect to YouTrack')[source]

Bases: YouTrackError

Connection related errors.

Parameters:

message (str)

__init__(message: str = 'Failed to connect to YouTrack')[source]
Parameters:

message (str)

exception youtrack_cli.exceptions.ValidationError(message: str, field: str | None = None)[source]

Bases: YouTrackError

Input validation errors.

Parameters:

  • message (str)

  • field (str | None)

__init__(message: str, field: str | None = None)[source]
Parameters:

  • message (str)

  • field (str | None)

exception youtrack_cli.exceptions.NotFoundError(resource_type: str, identifier: str)[source]

Bases: YouTrackError

Resource not found errors.

Parameters:

  • resource_type (str)

  • identifier (str)

__init__(resource_type: str, identifier: str)[source]
Parameters:

  • resource_type (str)

  • identifier (str)

exception youtrack_cli.exceptions.PermissionError(action: str, resource: str | None = None)[source]

Bases: YouTrackError

Permission denied errors.

Parameters:

  • action (str)

  • resource (str | None)

__init__(action: str, resource: str | None = None)[source]
Parameters:

  • action (str)

  • resource (str | None)

exception youtrack_cli.exceptions.RateLimitError(retry_after: int | None = None)[source]

Bases: YouTrackError

Rate limit exceeded errors.

Parameters:

retry_after (int | None)

__init__(retry_after: int | None = None)[source]
Parameters:

retry_after (int | None)

exception youtrack_cli.exceptions.YouTrackNetworkError(message: str = 'Network error occurred')[source]

Bases: YouTrackError

Network related errors that may be retryable.

Parameters:

message (str)

__init__(message: str = 'Network error occurred')[source]
Parameters:

message (str)

exception youtrack_cli.exceptions.YouTrackServerError(message: str = 'Server error occurred', status_code: int | None = None)[source]

Bases: YouTrackError

Server-side errors that may be retryable.

Parameters:

  • message (str)

  • status_code (int | None)

__init__(message: str = 'Server error occurred', status_code: int | None = None)[source]
Parameters:

  • message (str)

  • status_code (int | None)

exception youtrack_cli.exceptions.CommandValidationError(message: str, command_path: str | None = None, usage_example: str | None = None, similar_commands: List[str] | None = None)[source]

Bases: YouTrackError

Errors related to command structure and usage.

Parameters:

  • message (str)

  • command_path (str | None)

  • usage_example (str | None)

  • similar_commands (List[str] | None)

__init__(message: str, command_path: str | None = None, usage_example: str | None = None, similar_commands: List[str] | None = None)[source]
Parameters:

  • message (str)

  • command_path (str | None)

  • usage_example (str | None)

  • similar_commands (List[str] | None)

exception youtrack_cli.exceptions.ParameterError(message: str, parameter_name: str | None = None, expected_type: str | None = None, usage_example: str | None = None, valid_choices: List[str] | None = None)[source]

Bases: YouTrackError

Errors related to command parameters and arguments.

Parameters:

  • message (str)

  • parameter_name (str | None)

  • expected_type (str | None)

  • usage_example (str | None)

  • valid_choices (List[str] | None)

__init__(message: str, parameter_name: str | None = None, expected_type: str | None = None, usage_example: str | None = None, valid_choices: List[str] | None = None)[source]
Parameters:

  • message (str)

  • parameter_name (str | None)

  • expected_type (str | None)

  • usage_example (str | None)

  • valid_choices (List[str] | None)

exception youtrack_cli.exceptions.UsageError(message: str, command_path: str, usage_syntax: str, examples: List[str] | None = None, common_mistakes: List[str] | None = None)[source]

Bases: YouTrackError

Errors that provide comprehensive usage guidance.

Parameters:

  • message (str)

  • command_path (str)

  • usage_syntax (str)

  • examples (List[str] | None)

  • common_mistakes (List[str] | None)

__init__(message: str, command_path: str, usage_syntax: str, examples: List[str] | None = None, common_mistakes: List[str] | None = None)[source]
Parameters:

  • message (str)

  • command_path (str)

  • usage_syntax (str)

  • examples (List[str] | None)

  • common_mistakes (List[str] | None)

exception youtrack_cli.exceptions.TokenRefreshError(message: str = 'Token refresh failed')[source]

Bases: AuthenticationError

Token refresh related errors.

Parameters:

message (str)

__init__(message: str = 'Token refresh failed')[source]
Parameters:

message (str)

exception youtrack_cli.exceptions.TokenExpiredError(message: str = 'Token has expired')[source]

Bases: AuthenticationError

Token expiration related errors.

Parameters:

message (str)

__init__(message: str = 'Token has expired')[source]
Parameters:

message (str)