Metadata-Version: 2.4
Name: markmaton
Version: 0.1.4
Summary: Lightweight HTML-to-Markdown tooling for agent workflows.
Project-URL: Homepage, https://github.com/appautomaton/markmaton
Project-URL: Repository, https://github.com/appautomaton/markmaton
Project-URL: Issues, https://github.com/appautomaton/markmaton/issues
Author: appautomaton
License: MIT
License-File: LICENSE
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# markmaton

Lightweight HTML-to-Markdown tooling for agent workflows.

## Status

This repository is intentionally starting small.

The current goal is to build a clean, fast parser core that can:

- take normalized page HTML from tools like Playwright, `fetch`, or no-driver
- clean the page structure
- return robust Markdown and page metadata

## Direction

- parser core: Go
- distribution: Python packaging / PyPI
- first focus: library and CLI for local agent use
- release track: GitHub Actions + Trusted Publishing

## Current shape

- Go engine: `cmd/markmaton-engine`
- Python wrapper: `markmaton/`
- Architecture docs: `docs/`
- Plans and issue CSVs: `plan/` and `issues/`

## Testing policy

- automated tests should be unit-test-first
- parser module tests should use local fixtures and golden files
- Python wrapper tests should mock the engine boundary
- real engine checks stay manual unless there is a strong reason to automate them

## Testing layout

- Go package unit tests live beside each package under `internal/*`.
- Shared Go fixture/golden helpers live in `internal/testutil/`.
- Stable parser fixtures live under `testdata/fixtures/core/`.
- Real-world regression fixtures live under `testdata/fixtures/regression/`.
- Golden markdown outputs for stable core fixtures live under `testdata/golden/core/`.
- Python wrapper tests live under `tests/unit/`.

## Local smoke

See:

- `docs/local-smoke.md`
- `docs/packaging-layout.md`
- `docs/pypi-release.md`
