Skip to content
Transport adapter for fetching file:// URLs with the requests python library
Branch: master
Clone or download
dashea Delete the spec file
This file hasn't been updated in a while, pretty sure it's out of date.
Latest commit 75b96b6 Oct 22, 2019


Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore Initial commit Mar 10, 2015
CHANGES.rst New release 1.4.3 Jan 2, 2018
LICENSE Initial commit Mar 10, 2015 Include extra files via Mar 10, 2015
README.rst Fix spelling. Mar 10, 2015 Update Apr 28, 2017
requirements.txt Initial commit Mar 10, 2015
setup.cfg Release as a universal wheel Oct 13, 2016 New release 1.4.3 Jan 2, 2018



Requests-File is a transport adapter for use with the Requests Python library to allow local filesystem access via file:// URLs.

To use:

import requests
from requests_file import FileAdapter

s = requests.Session()
s.mount('file://', FileAdapter())

resp = s.get('file:///path/to/file')


  • Will open and read local files
  • Might set a Content-Length header
  • That's about it

No encoding information is set in the response object, so be careful using Response.text: the chardet library will be used to convert the file to a unicode type and it may not detect what you actually want.

EACCES is converted to a 403 status code, and ENOENT is converted to a 404. All other IOError types are converted to a 400.


Contributions welcome! Feel free to open a pull request against


To maximise compatibility with Requests, this code is licensed under the Apache license. See LICENSE for more details.

You can’t perform that action at this time.