---
id: apeye
version: "1.4.1"
license: unclear
license_treatment: copyleft
maintenance: active
---

# apeye — Handy tools for working with URLs and APIs.

License: copyleft · Maintenance: active · Downloads: 856.5K/mo

## 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 above — 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

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

- License: not declared (copyleft)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 856.5K/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

url handling pathlib-like, http request caching, api rate limiting, json cache decorator, rest client utilities, request rate control, url manipulation tools, http-client, caching, rate-limiting

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