Metadata-Version: 2.1
Name: teletiffinfo
Version: 0.0.3
Summary: Fetch metadata from remote (https) tiff.
Home-page: https://github.com/xgui3783/teletiffinfo
Author: Xiao Gui
Author-email: xgui3783@gmail.com
License: UNKNOWN
Platform: UNKNOWN
Description-Content-Type: text/markdown
License-File: LICENSE

# teletiffinfo

Read metadata of remote TIFF according to [TIFF6 spec](https://www.adobe.io/open/standards/TIFF.html) (currently only reads width and height.)

## Requirements

server must support [RANGE request](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Range).

## Why?

For large TIFF files, it is often not feasible to download the full TIFF file in order to access the metadata. 

## Installation

- via pip
```sh
pip install teletiffinfo
```

## Usage

```python
from teletiffinfo import try_tiff
try_tiff("https://file-examples-com.github.io/uploads/2017/10/file_example_TIFF_10MB.tiff") # returns (1950, 1301)
```

One could also add any custom header
```python
from teletiffinfo import try_tiff
try_tiff("https://my.example.com/protected_tiff.tiff", {
    "Authorization": "Bearer ey..."
})
```

## License

MIT


