Metadata-Version: 2.4
Name: bookshare
Version: 0.11.0
Summary: Bookshare API wrapper
Author-email: Q <q@q-continuum.net>
License: MIT
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.7
Requires-Dist: requests>=2.25.0
Provides-Extra: dev
Requires-Dist: black; extra == 'dev'
Requires-Dist: hypothesis>=6.70.0; extra == 'dev'
Requires-Dist: mypy; extra == 'dev'
Requires-Dist: pre-commit; extra == 'dev'
Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
Requires-Dist: pytest-mock>=3.10.0; extra == 'dev'
Requires-Dist: pytest-recording>=0.12.0; extra == 'dev'
Requires-Dist: pytest>=7.0; extra == 'dev'
Requires-Dist: responses>=0.23.0; extra == 'dev'
Requires-Dist: ruff; extra == 'dev'
Provides-Extra: test
Requires-Dist: hypothesis>=6.70.0; extra == 'test'
Requires-Dist: pytest-cov>=4.0.0; extra == 'test'
Requires-Dist: pytest-mock>=3.10.0; extra == 'test'
Requires-Dist: pytest-recording>=0.12.0; extra == 'test'
Requires-Dist: pytest>=7.0; extra == 'test'
Requires-Dist: responses>=0.23.0; extra == 'test'
Description-Content-Type: text/markdown

# Bookshare API Wrapper

[![Tests](https://github.com/accessibleapps/bookshare/actions/workflows/test.yml/badge.svg)](https://github.com/accessibleapps/bookshare/actions/workflows/test.yml)
[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)

A Python wrapper for the Bookshare API that provides access to accessible books and educational materials.

## Installation

```bash
uv add bookshare
```

## Usage

```python
from bookshare import BookshareAPI

# Initialize with API key
api = BookshareAPI(API_key="your_api_key")

# Search for books
results = api.title_search("python programming")

# Get book details
book = api.isbn_lookup("9780134685991")
```

## API Methods

- `category_list()` - Get available book categories
- `grade_list()` - Get available grade levels  
- `title_search(query)` - Search books by title
- `author_search(query)` - Search books by author
- `isbn_lookup(isbn)` - Get book by ISBN
- `book_lookup(book_id)` - Get book by Bookshare ID
- `latest()` - Get latest books
- `popular()` - Get popular books
- `download(book_id, version)` - Download book content

## Development

```bash
# Clone and setup
git clone https://github.com/accessibleapps/bookshare.git
cd bookshare
uv sync --extra dev

# Run tests
uv run pytest

# Run linting
uv run ruff check .
uv run ruff format .
```