Metadata-Version: 2.3
Name: grass-html
Version: 0.2.0
Summary: Extract Markdown and structured metadata from HTML.
Author: grass-html maintainers
Requires-Dist: beautifulsoup4>=4.15.0
Requires-Dist: magic-html>=0.1.8
Requires-Dist: tiktoken>=0.14.0
Requires-Dist: trafilatura>=2.2.0
Requires-Dist: markdownify>=0.13.0
Requires-Dist: lxml>=5.0.0
Requires-Python: >=3.12
Description-Content-Type: text/markdown

# grass-html

Extract Markdown and structured metadata from HTML.

## Install

```bash
pip install grass-html
```

## Usage

```python
from grass_html import extract, to_markdown, to_json

result = extract(html_string)
print(result.markdown)
print(result.degraded)   # True when extraction coverage is low
print(result.coverage)   # ratio vs full-page markdown

md = to_markdown(html_string)
doc = to_json(html_string)
```

## Features

- Single extraction profile: Markdown body + metadata
- Links and images always preserved
- Degradation detection via coverage threshold
- Structural verification utilities (`structural_report`, `boilerplate_probes`)

## CLI

```bash
grass-html path/to/file.html
```

## Status

Early stage. API may change between minor releases.
