---
id: zope-globalrequest
version: "3.0"
license: ZPL
license_treatment: unclear
maintenance: aging
---

# zope.globalrequest — Global way of retrieving the currently active request.

License: unclear · Maintenance: aging · Downloads: 125.0K/mo

## What it is and what it does

zope.globalrequest is a small utility that exposes a single function, getRequest(), to retrieve the currently active HTTP request object in Zope and Plone web applications without threading it through function parameters. It works by hooking into Zope's request-handling machinery via zope.publisher and zope.traversing.

The package is explicitly designed for the Zope/Plone ecosystem, where it serves as a convenience for accessing request context. The Zope3 framework itself discourages this pattern in favor of explicit dependency injection, so this package is most relevant for legacy Plone codebases or projects that prioritize pragmatism over strict separation of concerns. It has no external dependencies beyond the Zope framework stack itself.

Use it for:

- Retrieve the current HTTP request in Plone add-ons without modifying function signatures throughout the codebase.
- Access request headers, form data, or session information from deeply nested utility functions in Zope applications.
- Migrate legacy Plone code that relies on implicit request availability to modern Python versions.
- Implement request-scoped caching or logging in Zope middleware without explicit parameter passing.

## Worth the install?

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

Provides a function to retrieve the currently active request object in Zope-based web frameworks without passing it through function parameters.

Yes, if you are actively developing or maintaining Plone or Zope applications. The package is stable, has no known vulnerabilities, and installs with low friction. No, if you are starting a new Zope3 project or prefer explicit dependency injection patterns. The aging maintenance status (336 days since last release) is not a blocker for a stable utility, but verify that your Zope/Plone version is compatible before relying on it for new projects.

## Install

pip install zope-globalrequest
uv add zope-globalrequest
poetry add zope-globalrequest

## Installing zope.globalrequest

Before you install: Low friction installation with a pure-Python wheel. Maintenance is aging—last release was 336 days ago—but the package remains active on the Zope Foundation repository and supports current Python versions (3.9–3.13).

License in practice: Licensed under ZPL (Zope Public License), which is OSI-approved. License treatment is marked unclear in the fact sheet, so verify the specific terms if your project has strict licensing requirements.

Quickstart:

pip install zope.globalrequest

from zope.globalrequest import getRequest
request = getRequest()

Requires Python 3.9 or later. Intended for use within Zope or Plone web frameworks; behavior outside those contexts is not documented.

Verify before relying:

- Whether getRequest() returns None or raises an exception when called outside an active Zope request context.
- Performance implications of global request retrieval in high-concurrency scenarios.
- Compatibility with async/ASGI-based Zope deployments.

## Package facts

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

## Tags

zope request context, global request object zope, zope request retrieval, contextless request access, zope web framework request, plone request handling, zope3 request pattern, zope-ecosystem, request-context, plone

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