Metadata-Version: 2.4
Name: seekablehttpfile
Version: 0.1.1
Summary: A lazy-loading, seekable, remote file object using http range requests
Home-page: https://github.com/thatch/seekablehttpfile/
Author: Tim Hatch
Author-email: tim@timhatch.com
License: MIT
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests
Requires-Dist: keke
Provides-Extra: dev
Requires-Dist: black==23.12.1; extra == "dev"
Requires-Dist: checkdeps==0.9.0; extra == "dev"
Requires-Dist: flake8==7.0.0; extra == "dev"
Requires-Dist: mypy==1.8.0; extra == "dev"
Requires-Dist: tox==4.12.1; extra == "dev"
Requires-Dist: twine==4.0.2; extra == "dev"
Requires-Dist: ufmt==2.3.0; extra == "dev"
Requires-Dist: usort==1.0.7; extra == "dev"
Requires-Dist: wheel==0.42.0; extra == "dev"
Requires-Dist: pip; extra == "dev"
Provides-Extra: test
Requires-Dist: coverage>=6; extra == "test"
Dynamic: license-file

# seekablehttpfile

This project provides a file-like object that fetches parts of a file using HTTP
range requests as needed.

```pycon
>>> from seekablehttpfile import SeekableHttpFile
>>> from zipfile import ZipFile

>>> f = SeekableHttpFile("https://files.pythonhosted.org/packages/cb/90/599c79a248dcae6935331113649de5d75427e320efde21b583648b498584/tensorflow_intel-2.14.0-cp310-cp310-win_amd64.whl")  # 284MB
>>> # use as normal, for example with ZipFile
>>> z = ZipFile(f)
>>> len(z.namelist())
9414
>>> # find out how much we actually read
>>> f.stats
{'num_requests': 2, 'optimistic_bytes_read': 256000, 'lazy_bytes_read': 1078669, 'satisfied_from_cache': 2}

```

# Version Compatibility

Users of this library should be able to use Python 3.7 or above.  This is
validated by tests, and is the version encoded in `Requires-Python`.

Development requires Python 3.12 (or 3.13), realistically.  CI validates that it
works on 3.10 and above, but you will get less checking in flake8.  Expect older
versions to be dropped as soon as there is a version of mypy, black, etc that is
not simultaneously compatible with all development versions.

Notably, this means that while this project might function (and pass tests) on
Python 3.7, it's likely that you can't typecheck against it.

# License

seekablehttpfile is copyright [Tim Hatch](https://timhatch.com/), and licensed under
the MIT license.  I am providing code in this repository to you under an open
source license.  This is my personal repository; the license you receive to
my code is from me and not from my employer. See the `LICENSE` file for details.
