decant-cli 0.1.0__py3-none-any.whl

decant_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,63 @@
+Metadata-Version: 2.4
+Name: decant-cli
+Version: 0.1.0
+Summary: Convert semantic HTML to dyslexia-friendly readable HTML
+Author: Dave Zack
+License: MIT
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: beautifulsoup4>=4.12.0
+Requires-Dist: lxml>=5.0.0
+Requires-Dist: nh3>=0.2.0
+Requires-Dist: trafilatura>=1.8.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: flask>=3.0.0; extra == "dev"
+Requires-Dist: requests>=2.31.0; extra == "dev"
+Dynamic: license-file
+
+# Flowdoc
+
+Flowdoc is a free, open-source CLI tool that converts web articles into clean, accessible, self-contained HTML files styled for readers with dyslexia and related conditions. It strips site chrome, extracts article content, and produces a single portable document with BDA-recommended typography -- printable, offline-readable, and ready to hand to a student or email to a teacher.
+
+Many documents are technically "readable" but visually fatiguing for readers with dyslexia due to cramped line length, poor spacing, and layout choices that prioritize appearance over readability. Browser Reader Mode helps but is ephemeral -- you cannot save it, print it with controlled typography, or share it reliably. Flowdoc produces actual documents.
+
+## v1 scope (summary)
+
+- Input: HTML with semantic structure (headings, paragraphs, lists)
+- Output: a single, self-contained HTML file (no external CSS/fonts/scripts/images)
+- Readability over fidelity: no attempt to preserve original styling or branding
+- Optional font toggle: `--font opendyslexic` (not default)
+
+Full boundaries: see [SCOPE.md](SCOPE.md).
+
+## Status
+
+Phase 2 complete. Core pipeline built and tested against 11 real-world fixtures (8 clean passes, 1 marginal, 2 known limitations). Preparing for v1 open-source release.
+
+## Planned CLI
+
+```bash
+flowdoc convert input.html
+flowdoc convert input.html -o output.html
+flowdoc convert input.html --font opendyslexic
+```
+
+Print to PDF: open the output in a browser and use print-to-PDF.
+
+## Documentation
+
+- [SCOPE.md](SCOPE.md) - frozen v1 product boundaries and success criteria
+- [docs/decisions.md](docs/decisions.md) - authoritative implementation/test spec (contracts + invariants)
+- [docs/architecture.md](docs/architecture.md) - locked v1 implementation choices (runtime, libraries, module structure, pipeline, testing)
+- [docs/flowdoc-v1-plan.md](docs/flowdoc-v1-plan.md) - execution checklist for v1
+- [docs/flowdoc-v1-success-contract.md](docs/flowdoc-v1-success-contract.md) - locked v1 success contract (takes precedence over all other docs where conflicts exist)
+- [docs/research_typography_guidelines.md](docs/research_typography_guidelines.md) - typography research/reference
+- [flowdoc-elevator-pitch.md](flowdoc-elevator-pitch.md) - what Flowdoc is in 60 seconds
+- [docs/flowdoc-project-summary.md](docs/flowdoc-project-summary.md) - project history and context
+- [ABOUT.md](ABOUT.md) - project origin story and motivation
+
+## License
+
+[MIT](LICENSE)

decant_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,20 @@
+decant/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+decant/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+decant/cli/main.py,sha256=EABG8oab3yioZepqacfk2R5AAMEPznP4eOmcecWZtH4,4539
+decant/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+decant/core/constants.py,sha256=Cl3aZRA-Syp4oXYoCoT_pBdmqbkJQZqmgeKewk3cDDo,283692
+decant/core/content_selector.py,sha256=UBMtZrhJVyvFRyl0xuIjx8WCPZPX3ZrVzzbOiQRVkfg,2002
+decant/core/degradation.py,sha256=1vUKMEmQRmmErOZJswVYYwdGT0IQY4-GQL29TvMR1oU,4022
+decant/core/model.py,sha256=1-Sx7wZkPS4TVThq7Vv1XEuaYGPGAGpyNwfX1n69Na8,2706
+decant/core/parser.py,sha256=OfKKZFiW67cPA_VeeR4Zt2U4hbx5RsjCOyLwuvMwgA8,37329
+decant/core/renderer.py,sha256=aCHKcRI_Ptj85-roJrPSJuOrijAS8gAplVEu3y8nBsA,14099
+decant/core/sanitizer.py,sha256=3pGyoKdUpYEZj9axOtTQ1xbge-2fx7eZBWhG2gy9FS0,1630
+decant/io/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+decant/io/reader.py,sha256=0bKdmyd9btYdPzhR6Nrl3LFEWpDFZbXr2747GVs2moI,689
+decant/io/writer.py,sha256=hH_HNuzDox3sGQTpFd3Dxamo_t1FE75B6q5PFdXRHJE,552
+decant_cli-0.1.0.dist-info/licenses/LICENSE,sha256=1FYm9Vr4GG9q9V0O2mSjA-NffONcpzNGRtEdqI6fnoY,1086
+decant_cli-0.1.0.dist-info/METADATA,sha256=vNeHkZNmmnx7tgPtfDm9xT1_UbXg9pRVIgbE8yqTCSo,3090
+decant_cli-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+decant_cli-0.1.0.dist-info/entry_points.txt,sha256=zyzNZElxsd9jsn8LvGNsGP9hmopONCuNoptY8wJRRXo,48
+decant_cli-0.1.0.dist-info/top_level.txt,sha256=FngyfE_yssSQ9QWlsNqyazGq8CLkTyBetCcJxjN4awY,7
+decant_cli-0.1.0.dist-info/RECORD,,

decant_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

decant_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+decant = decant.cli.main:main

decant_cli-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 David Zack
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

decant_cli-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+decant