nepse_client.exceptions

Custom exceptions for NEPSE Client.

This module provides a comprehensive exception hierarchy for handling various error scenarios when interacting with the NEPSE API.

Functions

get_exception_for_status(status_code, message)

Get appropriate exception class for HTTP status code.

Exceptions

NepseAuthenticationError	Raised when access token has expired (401 Unauthorized).
NepseBadGatewayError	Raised when server returns 502 Bad Gateway.
NepseClientError	Raised when client sends an invalid request (4xx errors).
NepseConfigurationError	Raised when there's an issue with client configuration.
NepseConnectionError	Raised when connection to NEPSE server fails.
NepseDataNotFoundError	Raised when requested data is not found.
NepseError	Base exception class for all NEPSE-related errors.
NepseNetworkError	Raised for general network or unexpected HTTP issues.
NepseRateLimitError	Raised when API rate limit is exceeded (429 Too Many Requests).
NepseServerError	Generic server error for 5xx status codes.
NepseTimeoutError	Raised when request times out.
NepseValidationError	Raised when input validation fails before making API request.

exception nepse_client.exceptions.NepseError

Bases: Exception

Base exception class for all NEPSE-related errors.

All custom exceptions in this library inherit from this class, allowing for easy catch-all error handling.

message

Human-readable error description

status_code

HTTP status code (if applicable)

response_data

Raw response data from the API

request_data

Original request data

__init__(message, status_code=None, response_data=None, request_data=None)

Initialize NepseError.

Parameters:

• message (str) – Error description

• status_code (Optional[int]) – HTTP status code

• response_data (Optional[Any]) – Response from the API

• request_data (Optional[dict[str, Any]]) – Original request data

__str__()

Return string representation of the error.

Return type:

str

__repr__()

Return detailed representation of the error.

Return type:

str

to_dict()

Convert exception to dictionary for logging/serialization.

Return type:

dict[str, Any]

Returns:

Dictionary representation of the exception

exception nepse_client.exceptions.NepseClientError

Bases: NepseError

Raised when client sends an invalid request (4xx errors).

This typically indicates: - Invalid parameters - Missing required fields - Malformed request data - Invalid company symbol

Example

>>> try:
...     client.getCompanyDetails("INVALID")
... except NepseClientError as e:
...     print(f"Invalid request: {e}")

__init__(message='Invalid client request', status_code=400, response_data=None, request_data=None)

Initialize the exception with a default message.

Parameters:

• message (str)

• status_code (int)

• response_data (Any | None)

• request_data (dict[str, Any] | None)

exception nepse_client.exceptions.NepseAuthenticationError

Bases: NepseError

Raised when access token has expired (401 Unauthorized).

This exception is typically handled automatically by the client, which will refresh the token and retry the request.

Note

Users usually don’t need to handle this exception directly as the client manages token refresh automatically.

__init__(message='Authentication token expired', status_code=401, response_data=None)

Initialize the exception with a default message.

Parameters:

• message (str)

• status_code (int)

• response_data (Any | None)

exception nepse_client.exceptions.NepseBadGatewayError

Bases: NepseError

Raised when server returns 502 Bad Gateway.

This typically indicates: - Server temporarily unavailable - Upstream server issues - Network problems between servers

Recommended action: Retry the request after a short delay.

__init__(message='Bad Gateway - Server temporarily unavailable', status_code=502, response_data=None)

Initialize the exception with a default message.

Parameters:

• message (str)

• status_code (int)

• response_data (Any | None)

exception nepse_client.exceptions.NepseServerError

Bases: NepseError

Generic server error for 5xx status codes.

This indicates an error on the NEPSE server side. Common causes: - Internal server error (500) - Service unavailable (503) - Gateway timeout (504)

Recommended action: Retry with exponential backoff or contact support.

__init__(message='Server error occurred', status_code=500, response_data=None)

Initialize the exception with a default message.

Parameters:

• message (str)

• status_code (int)

• response_data (Any | None)

exception nepse_client.exceptions.NepseNetworkError

Bases: NepseError

Raised for general network or unexpected HTTP issues.

This covers: - Connection timeouts - DNS resolution failures - SSL/TLS errors - Unexpected response formats - Network interruptions

Recommended action: Check network connectivity and retry.

__init__(message='Network error occurred', status_code=None, response_data=None)

Initialize the exception with a default message.

Parameters:

• message (str)

• status_code (int | None)

• response_data (Any | None)

exception nepse_client.exceptions.NepseValidationError

Bases: NepseError

Raised when input validation fails before making API request.

This is raised for client-side validation errors such as: - Invalid date formats - Out of range values - Missing required parameters - Invalid data types

Example

>>> try:
...     client.getCompanyPriceVolumeHistory("NABIL", start_date="invalid")
... except NepseValidationError as e:
...     print(f"Validation error: {e}")

__init__(message='Input validation failed', field=None, value=None)

Initialize validation error.

Parameters:

• message (str) – Error description

• field (Optional[str]) – Name of the invalid field

• value (Optional[Any]) – Invalid value provided

exception nepse_client.exceptions.NepseRateLimitError

Bases: NepseError

Raised when API rate limit is exceeded (429 Too Many Requests).

retry_after

Seconds to wait before retrying (if provided by server)

__init__(message='Rate limit exceeded', status_code=429, retry_after=None)

Initialize rate limit error.

Parameters:

• message (str) – Error description

• status_code (int) – HTTP status code

• retry_after (Optional[int]) – Seconds to wait before retry

exception nepse_client.exceptions.NepseDataNotFoundError

Bases: NepseError

Raised when requested data is not found.

This is used when: - Company symbol doesn’t exist - No data available for requested date - Empty result sets

Example

>>> try:
...     client.getFloorSheetOf("INVALID", "2024-01-01")
... except NepseDataNotFoundError as e:
...     print(f"Data not found: {e}")

__init__(message='Requested data not found', resource=None)

Initialize data not found error.

Parameters:

• message (str) – Error description

• resource (Optional[str]) – Resource that was not found

exception nepse_client.exceptions.NepseTimeoutError

Bases: NepseError

Raised when request times out.

This occurs when the server doesn’t respond within the specified timeout period.

timeout

Timeout value in seconds

__init__(message='Request timeout', timeout=None)

Initialize timeout error.

Parameters:

• message (str) – Error description

• timeout (Optional[float]) – Timeout value in seconds

exception nepse_client.exceptions.NepseConnectionError

Bases: NepseError

Raised when connection to NEPSE server fails.

This is different from NepseNetworkError as it specifically indicates inability to establish a connection.

__init__(message='Failed to connect to NEPSE server')

Initialize the exception with a default message.

Parameters:

message (str)

exception nepse_client.exceptions.NepseConfigurationError

Bases: NepseError

Raised when there’s an issue with client configuration.

This includes: - Missing required configuration files - Invalid configuration values - Corrupted data files

__init__(message='Configuration error')

Initialize the exception with a default message.

Parameters:

message (str)

nepse_client.exceptions.get_exception_for_status(status_code, message, response_data=None)

Get appropriate exception class for HTTP status code.

Parameters:

• status_code (int) – HTTP status code

• message (str) – Error message

• response_data (Optional[Any]) – Response data from API

Return type:

NepseError

Returns:

Appropriate exception instance