apeye

What it is and what it does

apeye is a utility library for working with URLs and HTTP APIs in Python. It provides three main tools: pathlib-like URL objects that let you construct and manipulate URLs with familiar path-like syntax, a JSON-backed cache decorator to avoid redundant function calls, and a CacheControl adapter that integrates with requests to rate-limit HTTP requests. The package wraps requests and related utilities to make common API and URL-handling patterns more convenient.

It's designed for developers building HTTP clients, API wrappers, or tools that need to manage URL construction, response caching, or request throttling. The library supports Python 3.6 and later, including PyPy, and is actively maintained. Most functionality is available out of the box; rate-limiting via the rate_limiter module requires an optional 'limiter' extra.

Use it for:

• Build API client libraries with URL construction and request rate-limiting built in
• Cache expensive API calls to avoid redundant network requests during development or testing
• Construct and manipulate URLs programmatically using a familiar pathlib-like interface
• Throttle HTTP requests to respect API rate limits or reduce server load
• Combine URL handling, caching, and rate control in a single dependency

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

apeye provides pathlib-like URL objects, a JSON-backed cache decorator, and a CacheControl adapter for rate-limiting HTTP requests.

Yes. apeye is actively maintained, has low install friction, no known vulnerabilities, and solves a real problem for API and URL-heavy code. The copyleft license (LGPLv3+) is a consideration if you're building proprietary software, but poses no issue for open-source or internal tools. Install it if you need convenient URL handling, response caching, or request rate-limiting in an HTTP client.

Install

apeye on PyPI

pip install apeye

uv add apeye

poetry add apeye

Installing apeye

Before you install

Low install friction with a pure-wheel distribution. Actively maintained with recent commits; supports Python 3.6 through 3.11 and PyPy.

License in practice

Licensed under LGPLv3+, a copyleft license requiring derivative works to be licensed under compatible terms and source code to be made available.

Quickstart

pip install apeye

from apeye import URL
url = URL('https://api.example.com') / 'endpoint'
response = url.get()

Rate-limiting via the rate_limiter module requires the optional 'limiter' extra to be installed separately.

Verify before relying

• Whether the rate_limiter module's optional 'limiter' extra adds significant functionality or is rarely needed
• Performance characteristics when caching large API responses or handling high request volumes

Package facts

Evidence: apeye-1.4.1-py3-none-any.whl

Keywords: api, cache, requests, rest, url

Tags

More Python Modules packages