:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.
Python ab-testingai-analyticsanalyticscdpdata-warehouseexperimentsfeature-flagsjavascriptproduct-analyticspythonreactsession-replaysurveystypescriptweb-analytics
class ApprovalException(Exception):
"""Base exception for approval-related errors"""
pass
class PreconditionFailed(ApprovalException):
"""Raised when preconditions for applying a change no longer hold"""
pass
class ApplyFailed(ApprovalException):
"""Raised when applying an approved change fails"""
pass
class InvalidIntent(ApprovalException):
"""Raised when intent data is invalid"""
pass
class PolicyEvaluationError(ApprovalException):
"""Raised when policy evaluation fails"""
pass
class ApprovalDetectionFailed(ApprovalException):
"""Raised when the gate cannot tell whether a change needs approval.
Detection reads the change through each action's ``detect``. When one of those raises, the
answer is unknown, not "no policy applies". Treating it as the latter lets a bug in one action
silently disable the policy it implements, so the write is refused instead.
"""
class ApprovalRequired(ApprovalException):
"""
Raised when an action requires approval.
This exception is raised from serializer methods when approval is required,
allowing the ViewSet to catch it and return the appropriate 409 response.
"""
def __init__(self, change_request, message: str, required_approvers: dict, error_code: str = "approval_required"):
self.change_request = change_request
self.message = message
self.required_approvers = required_approvers
self.error_code = error_code
super().__init__(message)
class PolicyConflict(ApprovalException):
"""
Raised when a single change would require approval under more than one policy.
Raised from serializer methods (mirroring ApprovalRequired) so the ViewSet can catch it and
return a 400 telling the caller to split the change — a single ChangeRequest can only carry
one action's approval, so a change matching several policy-backed actions can't be gated safely.
"""
def __init__(self, conflicting_policies: list, message: str, guidance: str):
self.conflicting_policies = conflicting_policies
self.message = message
self.guidance = guidance
super().__init__(message)
class ChangeRequestError(ApprovalException):
"""Base exception for change request service operations."""
pass
class InvalidStateError(ChangeRequestError):
"""Raised when operation is invalid for the current change request state."""
pass
class AlreadyVotedError(ChangeRequestError):
"""Raised when user has already voted on a change request."""
pass
class ReasonRequiredError(ChangeRequestError):
"""Raised when a reason is required but not provided."""
pass