---
id: zexceptions
version: "6.0"
license: ZPL-2.1
license_treatment: unclear
maintenance: active
---

# zExceptions — zExceptions contains common exceptions used in Zope.

License: unclear · Maintenance: active · Downloads: 145.7K/mo

## What it is and what it does

zExceptions is a library of exception classes and utilities designed for the Zope web framework ecosystem. It provides a standardized set of HTTP status exceptions, authorization and redirect exceptions, and helper functions for exception handling in Zope applications. The package is built on top of zope.interface, zope.publisher, and zope.security, making it a foundational component for Zope-based projects that need consistent exception semantics across the framework.

The library has been actively maintained since its first release and currently supports modern Python versions (3.10–3.14). It is primarily useful for developers building Zope applications or integrating with the Zope ecosystem, where standardized exception handling and HTTP status code representation are expected. The package has no known security vulnerabilities and is classified as mature.

Use it for:

- Raising HTTP status exceptions in Zope web applications with consistent response handling.
- Handling authorization failures with the Unauthorized exception class in Zope-based access control.
- Converting non-HTTP exceptions to HTTP exceptions for consistent error responses in Zope.
- Setting custom response headers and bodies on exceptions within Zope request/response cycles.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

zExceptions provides a collection of exception classes and utilities for Zope applications, including HTTP status exceptions and helper functions for exception handling.

Yes, if you are building or maintaining a Zope application or integrating with the Zope ecosystem. The package is actively maintained, has low install friction, and provides essential exception infrastructure for Zope projects. Not relevant for non-Zope applications. Verify ZPL-2.1 license compatibility before use.

## Install

pip install zexceptions
uv add zexceptions
poetry add zexceptions

## Installing zExceptions

Before you install: Low install friction with a pure-wheel distribution. Actively maintained as of 2026-02-19 with recent Python version support (3.10–3.14). Four runtime dependencies are all established Zope ecosystem packages.

License in practice: Licensed under ZPL-2.1 (Zope Public License), classified as OSI-approved. License treatment is marked unclear in the fact sheet; review the ZPL-2.1 terms directly if license compliance is a concern for your project.

Quickstart:

pip install zexceptions

from zexceptions import HTTPException, Unauthorized

exc = Unauthorized('Access denied')
print(exc)

Requires Python 3.10 or later; not compatible with earlier Python versions.

Verify before relying:

- Whether ZPL-2.1 is compatible with your project's license requirements (treatment marked unclear).
- Specific HTTP status codes supported and the full API surface beyond exception class names.
- Whether upgradeException and other helper functions are available and how they work.

## Package facts

- License: ZPL-2.1 (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 145.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

zope exception classes, http status exceptions, zope error handling, zope framework exceptions, common exception utilities, zope-ecosystem, http-exceptions, web-framework

[View on SkillFed](https://skillfed.io/packages/zexceptions) · [View on PyPI](https://pypi.org/project/zexceptions/)