requests-file
File transport adapter for Requests
Decision gist · record as of 2026-08-14
Yes, if you need to read local files through Requests Sessions. The package is simple, has no security vulnerabilities, and low install friction. The aging maintenance status (298 days since last release) is a minor concern for a stable, narrow-scope adapter, but not a blocker unless you need active development.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Low install friction with a single runtime dependency on requests.
- Marked as aging with no release in 298 days, though the project remains available and has been maintained since 2015.
License · maintenance · safety
Apache 2.0 (permissive) — Licensed under Apache 2.0 (permissive), which allows commercial and private use with minimal restrictions—compatible with most projects.
last release 2025-10-20 (298 days)
0 known vulnerabilities (OSV.dev, 2026-08-14) · 78,637,754 downloads/mo, #432 on PyPI
Alternatives
Verify before relying
import requests
from requests_file import FileAdapter
s = requests.Session()
s.mount('file://', FileAdapter())
resp = s.get('file:///path/to/file')- Whether chardet is automatically installed or optional for text decoding
- Current maintenance status and likelihood of future updates
What it is and what it does
Requests-File is a transport adapter that extends the Requests library to handle file:// URLs, letting you access local filesystem files using the same Session API you use for HTTP. It mounts a FileAdapter onto a Requests Session, converting file paths into response objects with basic HTTP-like semantics—setting Content-Length where possible and mapping filesystem errors (EACCES, ENOENT, etc.) to HTTP status codes (403, 404, 400).
The package is minimal and straightforward: it opens and reads local files. It does not set encoding information in responses, so text decoding relies on the chardet library to guess the file's encoding, which may not always be accurate. It's useful when you want to treat local file access uniformly with remote HTTP access in code that already uses Requests.
Use it for
- Unify local and remote file access in a tool that reads from both file:// and http:// URLs via Requests
- Test code that makes HTTP requests by substituting local test files via file:// URLs
- Build a configuration loader that accepts file:// URLs alongside http:// in a Requests-based client
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you need to read local files through Requests Sessions.
The package is simple, has no security vulnerabilities, and low install friction. The aging maintenance status (298 days since last release) is a minor concern for a stable, narrow-scope adapter, but not a blocker unless you need active development.
Install
requests-file on PyPI
Before you install
Low install friction with a single runtime dependency on requests. Marked as aging with no release in 298 days, though the project remains available and has been maintained since 2015.
License in practice
Licensed under Apache 2.0 (permissive), which allows commercial and private use with minimal restrictions—compatible with most projects.
Quickstart
import requests
from requests_file import FileAdapter
s = requests.Session()
s.mount('file://', FileAdapter())
resp = s.get('file:///path/to/file')Verify before relying
- Whether chardet is automatically installed or optional for text decoding
- Current maintenance status and likelihood of future updates
Package facts
| License | Apache 2.0 permissive |
| Python support | Not specified |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 1 packagerequests |
| Maintenance | Aging 298 days since the last release |
| First released | |
| Downloads | 78,637,754 / month, #432 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 3 - AlphaEnvironment :: PluginsIntended Audience :: DevelopersLicense :: OSI Approved :: Apache Software LicenseProgramming Language :: Python :: 3 |
Evidence: requests_file-3.0.1-py2.py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “file url adapter requests”
- requests-fileRequests-File adds file:// URL support to the Requests library,…
- requests-toolbeltProvides utilities for the requests library, including streaming…
- apeyeapeye provides pathlib-like URL objects, a JSON-backed cache…
Give your agent the search over MCP, or paste the wish link into any chat.
Similar packages
Adds PKCS#12 certificate support to the requests library without monkey patching, enabling client certificate authentication over HTTPS.
Intercepts and mocks HTTP requests made through the requests library, allowing you to stub out responses in tests without hitting real servers.
Install it if you write tests for code that makes HTTP calls.
Provides utilities for the requests library, including streaming multipart form-data encoding, SSL adapter configuration, cookie handling, and session management extensions.
However, the dormant maintenance status (last release 1201 days ago) means it may not track the latest requests or Python ecosystem changes.
Provides HTTP NTLM authentication for the requests library, enabling clients to authenticate against NTLM-protected servers and proxies.
Provides a drop-in replacement for mock.mock_open that supports multiple files, persistent file state across open calls, and standard file operations like read, write, seek, and tell.
Adds OAuth 1.0 authentication support to the requests library, allowing HTTP requests to be signed with OAuth credentials via header or URL-encoded methods.
See also requests-hardened · google-auth-httplib2 · requests-cache · requests-ratelimiter