Exceptions

Exception Hierarchy

ArchieError
├── ArcGISError                  ← ESRI returned an error envelope
│   ├── TokenExpiredError        ← token invalid or expired (code 498)
│   ├── TokenMissingError        ← token required but absent (code 499)
│   ├── AuthorizationError       ← insufficient permissions (code 403)
│   ├── NotFoundError            ← resource does not exist (code 404)
│   └── ServiceError             ← catch-all for other ESRI error codes
└── ArchieClientError            ← archibald itself caused this error
    ├── TokenRefreshError        ← token refresh attempted and failed
    ├── ConfigurationError       ← client or auth configured incorrectly
    ├── InvalidServiceURL        ← URL does not match expected service type
    ├── LayerCapabilityError     ← layer does not support the operation
    ├── InvalidParameterError    ← a caller-supplied parameter is invalid
    └── MissingGeometryError     ← geometry required but unavailable

Reference

archibald.exceptions.ArchieError

Bases: Exception

Root exception for all archibald errors.

archibald.exceptions.ArcGISError

Bases: ArchieError

ESRI returned an error envelope in the response body.

archibald.exceptions.TokenExpiredError

Bases: ArcGISError

Token is invalid or expired (ESRI code 498).

archibald.exceptions.TokenMissingError

Bases: ArcGISError

Token is required but absent (ESRI code 499).

archibald.exceptions.AuthorizationError

Bases: ArcGISError

Caller lacks permission for this resource (ESRI code 403).

archibald.exceptions.NotFoundError

Bases: ArcGISError

Requested resource does not exist (ESRI code 404).

archibald.exceptions.ServiceError

Bases: ArcGISError

Catch-all for unrecognised ESRI error codes.

archibald.exceptions.ArchieClientError

Bases: ArchieError

archibald itself caused this error, not ESRI.

archibald.exceptions.TokenRefreshError

Bases: ArchieClientError

A token refresh was attempted and failed.

archibald.exceptions.ConfigurationError

Bases: ArchieClientError

The client or auth object was configured incorrectly.

archibald.exceptions.InvalidServiceURL

Bases: ArchieClientError

The provided URL does not match the expected service type.

archibald.exceptions.LayerCapabilityError

Bases: ArchieClientError

The layer does not support the requested operation.

archibald.exceptions.InvalidParameterError

Bases: ArchieClientError

A parameter supplied by the caller is invalid.

archibald.exceptions.MissingGeometryError

Bases: ArchieClientError

A geometry-dependent operation was requested but geometry is unavailable.