Metadata-Version: 2.3
Name: libquery
Version: 0.1.2
Summary: A Python package for querying digital libraries and archives
Author: Yu Zhang
Author-email: yuzhang94@outlook.com
Requires-Python: >=3.10,<4.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Dist: backoff (>=2.2.1,<3.0.0)
Requires-Dist: internetarchive (>=3.5.0,<4.0.0)
Requires-Dist: pillow (==10.4.0)
Requires-Dist: python-dateutil (>=2.8.2,<3.0.0)
Requires-Dist: python-slugify (>=8.0.1,<9.0.0)
Requires-Dist: requests (>=2.32.3,<3.0.0)
Requires-Dist: tqdm (>=4.67.1,<5.0.0)
Requires-Dist: typing-extensions (>=4.7.1,<5.0.0)
Requires-Dist: xmltodict (>=0.13.0,<0.14.0)
Description-Content-Type: text/markdown

<a href="https://pypi.org/project/libquery/">
    <img alt="Newest PyPI version" src="https://img.shields.io/pypi/v/libquery.svg">
</a>
<a href="https://github.com/psf/black">
    <img alt="Code style: black" src="https://img.shields.io/badge/code%20style-black-000000.svg">
</a>
<a href="http://commitizen.github.io/cz-cli/">
    <img alt="Commitizen friendly" src="https://img.shields.io/badge/commitizen-friendly-brightgreen.svg">
</a>
<a href="https://pepy.tech/projects/libquery">
    <img alt="Pepy Total Downloads" src="https://img.shields.io/pepy/dt/libquery">
</a>

# libquery

A Python package for querying digital libraries and archives.
Supports multiple data sources including [David Rumsey Map Collection](https://www.davidrumsey.com/), [Gallica](https://gallica.bnf.fr/), [Internet Archive](https://archive.org/), and [Library of Congress](https://www.loc.gov/).

## Installation

```sh
pip install libquery
```

## Usage Example

Query metadata and images in [David Rumsey Map Collection](https://www.davidrumsey.com/):

```python
from libquery import DavidRumseyMapCollection
querier = DavidRumseyMapCollection("./metadata/", "./imgs/")
querier.fetch_metadata(["https://www.davidrumsey.com/luna/servlet/as/search?q=type=chart"])
querier.fetch_image()
```

## Documentation

See our [documentation website](https://oldvis.github.io/libquery/).

