docu-craft 0.1.0__tar.gz

docu_craft-0.1.0/LICENSE

@@ -0,0 +1,17 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   Copyright 2026 Christian A. Servin Lozano
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

docu_craft-0.1.0/PKG-INFO

@@ -0,0 +1,213 @@
+Metadata-Version: 2.4
+Name: docu-craft
+Version: 0.1.0
+Summary: Convert Markdown to polished documents with reusable themes
+Author-email: "Christian A. Servin Lozano" <cservinl@hotmail.com>
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://github.com/CServinL/docu-craft
+Project-URL: Repository, https://github.com/CServinL/docu-craft
+Project-URL: Documentation, https://github.com/CServinL/docu-craft/tree/main/docs
+Project-URL: Bug Tracker, https://github.com/CServinL/docu-craft/issues
+Keywords: markdown,pdf,document,themes,latex,weasyprint,reportlab
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: Education
+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
+Classifier: Topic :: Text Processing :: Markup
+Classifier: Topic :: Office/Business
+Classifier: Topic :: Documentation
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: markdown>=3.5
+Requires-Dist: weasyprint>=60
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: jinja2>=3.1
+Requires-Dist: Pygments>=2.16
+Provides-Extra: reportlab
+Requires-Dist: reportlab>=4.0; extra == "reportlab"
+Provides-Extra: docx
+Requires-Dist: python-docx>=1.1; extra == "docx"
+Provides-Extra: emoji
+Requires-Dist: emoji>=2.0; extra == "emoji"
+Provides-Extra: all
+Requires-Dist: docu_craft[docx,emoji,reportlab]; extra == "all"
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-cov>=5.0; extra == "dev"
+Requires-Dist: mkdocs>=1.6; extra == "dev"
+Requires-Dist: mkdocs-material>=9.0; extra == "dev"
+Dynamic: license-file
+
+# DocuCraft
+
+Stop writing PDFs by hand. Write Markdown, get a polished document.
+
+```python
+import docu_craft
+
+docu_craft.render("report.md", theme="scholar")
+```
+
+---
+
+## What it does
+
+You write content in Markdown. DocuCraft handles everything else:
+
+- **Picks a theme** — fonts, colors, margins, tables, code blocks, all styled consistently
+- **Validates structure** — checks that your document has the sections it needs before rendering
+- **Handles emoji** — replaces emoji characters with proper PNG images in the PDF
+- **Finds your assets** — themes, skeletons, and emoji sets from the package, your home folder, or any mounted path
+
+No more pasting CSS into scripts. No more fighting with PDF libraries. No more `weasyprint.HTML(string=html, base_url='.').write_pdf(...)` every time.
+
+---
+
+## Install
+
+```bash
+pip install docu_craft
+
+# with ReportLab support
+pip install "docu_craft[reportlab]"
+
+# everything
+pip install "docu_craft[all]"
+```
+
+---
+
+## Themes
+
+Built-in themes, ready to use:
+
+| Theme | Best for |
+|-------|----------|
+| `scholar` | Academic articles, PhD documents |
+| `handout` | Course materials, workshops |
+| `tech-doc` | API docs, technical references |
+| `official` | Institutional letters, formal reports |
+
+```python
+docu_craft.render("thesis.md", theme="scholar")
+docu_craft.render("class_notes.md", theme="handout")
+```
+
+Drop your own theme in `~/docu_craft/themes/mytheme/style.css` and use it the same way.
+
+---
+
+## Skeletons
+
+Skeletons define what sections a document should have. DocuCraft tells you if something is missing before you render.
+
+```python
+doc = docu_craft.Document("thesis.md")
+doc.apply_skeleton("academic_article").validate()  # raises if Introducción or Conclusiones missing
+doc.render()
+```
+
+Built-in skeletons: `academic_article`, `plan_trabajo`, `tech_doc`, `official_letter`, `course_handout`.
+
+Write your own in YAML or as a Python class with custom validation logic.
+
+---
+
+## Emoji in PDFs
+
+PDF fonts don't render emoji. DocuCraft swaps them for PNG images automatically.
+
+```python
+docu_craft.render("notes.md", theme="scholar", emoji_set="twemoji")
+```
+
+Two sets ship with the package: `noto-minimal` (60 common emoji, Apache 2.0) and `twemoji` (3800+ emoji, CC-BY 4.0). Download more:
+
+```bash
+python -m docu_craft.emoji.downloader twemoji
+python -m docu_craft.emoji.downloader noto
+```
+
+---
+
+## Config layers
+
+Set defaults once, override whenever you need:
+
+```yaml
+# ~/docu_craft/config.yaml — your personal defaults
+defaults:
+  theme: scholar
+  emoji_set: twemoji
+```
+
+```yaml
+# .docu_craft.yaml — per-project overrides
+defaults:
+  theme: handout
+```
+
+```markdown
+---
+theme: official
+---
+# Per-document frontmatter overrides everything above
+```
+
+```python
+# Explicit argument wins over all of the above
+docu_craft.render("file.md", theme="tech-doc")
+```
+
+---
+
+## Extended storage
+
+Point DocuCraft at any folder — a team share, a mounted drive, a network path. It searches all of them for themes, skeletons, and emoji sets.
+
+```python
+docu_craft.add_extended_store("/mnt/team/docu_craft-assets", name="team")
+docu_craft.add_extended_store("G:/Shared/styles", name="gdrive")
+```
+
+Or declare it in `.docu_craft.yaml`:
+
+```yaml
+extended_stores:
+  - /mnt/team/docu_craft-assets
+  - path: G:/Shared/styles
+    name: gdrive
+```
+
+---
+
+## Pluggable renderers
+
+```python
+docu_craft.register_renderer(
+    format="pdf",
+    module_path="mypackage.renderer:MyRenderer",
+    engine="myengine",
+    package="mypackage",
+    install="pip install mypackage",
+)
+
+doc.render(format="pdf", engine="myengine")
+```
+
+| Format | Engine | Status |
+|--------|--------|--------|
+| PDF | weasyprint | ✅ |
+| PDF | reportlab | 🚧 WIP |
+
+---
+
+## License
+
+Apache 2.0 © Christian A. Servin Lozano

docu_craft-0.1.0/README.md

@@ -0,0 +1,167 @@
+# DocuCraft
+
+Stop writing PDFs by hand. Write Markdown, get a polished document.
+
+```python
+import docu_craft
+
+docu_craft.render("report.md", theme="scholar")
+```
+
+---
+
+## What it does
+
+You write content in Markdown. DocuCraft handles everything else:
+
+- **Picks a theme** — fonts, colors, margins, tables, code blocks, all styled consistently
+- **Validates structure** — checks that your document has the sections it needs before rendering
+- **Handles emoji** — replaces emoji characters with proper PNG images in the PDF
+- **Finds your assets** — themes, skeletons, and emoji sets from the package, your home folder, or any mounted path
+
+No more pasting CSS into scripts. No more fighting with PDF libraries. No more `weasyprint.HTML(string=html, base_url='.').write_pdf(...)` every time.
+
+---
+
+## Install
+
+```bash
+pip install docu_craft
+
+# with ReportLab support
+pip install "docu_craft[reportlab]"
+
+# everything
+pip install "docu_craft[all]"
+```
+
+---
+
+## Themes
+
+Built-in themes, ready to use:
+
+| Theme | Best for |
+|-------|----------|
+| `scholar` | Academic articles, PhD documents |
+| `handout` | Course materials, workshops |
+| `tech-doc` | API docs, technical references |
+| `official` | Institutional letters, formal reports |
+
+```python
+docu_craft.render("thesis.md", theme="scholar")
+docu_craft.render("class_notes.md", theme="handout")
+```
+
+Drop your own theme in `~/docu_craft/themes/mytheme/style.css` and use it the same way.
+
+---
+
+## Skeletons
+
+Skeletons define what sections a document should have. DocuCraft tells you if something is missing before you render.
+
+```python
+doc = docu_craft.Document("thesis.md")
+doc.apply_skeleton("academic_article").validate()  # raises if Introducción or Conclusiones missing
+doc.render()
+```
+
+Built-in skeletons: `academic_article`, `plan_trabajo`, `tech_doc`, `official_letter`, `course_handout`.
+
+Write your own in YAML or as a Python class with custom validation logic.
+
+---
+
+## Emoji in PDFs
+
+PDF fonts don't render emoji. DocuCraft swaps them for PNG images automatically.
+
+```python
+docu_craft.render("notes.md", theme="scholar", emoji_set="twemoji")
+```
+
+Two sets ship with the package: `noto-minimal` (60 common emoji, Apache 2.0) and `twemoji` (3800+ emoji, CC-BY 4.0). Download more:
+
+```bash
+python -m docu_craft.emoji.downloader twemoji
+python -m docu_craft.emoji.downloader noto
+```
+
+---
+
+## Config layers
+
+Set defaults once, override whenever you need:
+
+```yaml
+# ~/docu_craft/config.yaml — your personal defaults
+defaults:
+  theme: scholar
+  emoji_set: twemoji
+```
+
+```yaml
+# .docu_craft.yaml — per-project overrides
+defaults:
+  theme: handout
+```
+
+```markdown
+---
+theme: official
+---
+# Per-document frontmatter overrides everything above
+```
+
+```python
+# Explicit argument wins over all of the above
+docu_craft.render("file.md", theme="tech-doc")
+```
+
+---
+
+## Extended storage
+
+Point DocuCraft at any folder — a team share, a mounted drive, a network path. It searches all of them for themes, skeletons, and emoji sets.
+
+```python
+docu_craft.add_extended_store("/mnt/team/docu_craft-assets", name="team")
+docu_craft.add_extended_store("G:/Shared/styles", name="gdrive")
+```
+
+Or declare it in `.docu_craft.yaml`:
+
+```yaml
+extended_stores:
+  - /mnt/team/docu_craft-assets
+  - path: G:/Shared/styles
+    name: gdrive
+```
+
+---
+
+## Pluggable renderers
+
+```python
+docu_craft.register_renderer(
+    format="pdf",
+    module_path="mypackage.renderer:MyRenderer",
+    engine="myengine",
+    package="mypackage",
+    install="pip install mypackage",
+)
+
+doc.render(format="pdf", engine="myengine")
+```
+
+| Format | Engine | Status |
+|--------|--------|--------|
+| PDF | weasyprint | ✅ |
+| PDF | reportlab | 🚧 WIP |
+
+---
+
+## License
+
+Apache 2.0 © Christian A. Servin Lozano

docu_craft-0.1.0/docu_craft/__init__.py

@@ -0,0 +1,38 @@
+from .document import Document
+from .themes import ThemeManager
+from .skeletons import SkeletonManager
+from .skeletons.manager import register as register_skeleton
+from .renderers import get_renderer
+from .renderers import register as register_renderer
+from .config import add_extended_store
+from .storage import registry, StorageRegistry, Store, StoreKind
+from pathlib import Path
+
+
+def render(
+    source: str | Path,
+    theme: str = "scholar",
+    format: str = "pdf",
+    output: str | Path | None = None,
+    engine: str | None = None,
+    emoji_set: str | None = None,
+) -> Path:
+    return Document(source).apply_theme(theme).render(
+        format=format, output=output, engine=engine, emoji_set=emoji_set
+    )
+
+
+__all__ = [
+    "Document",
+    "ThemeManager",
+    "SkeletonManager",
+    "get_renderer",
+    "register_renderer",
+    "register_skeleton",
+    "add_extended_store",
+    "registry",
+    "StorageRegistry",
+    "Store",
+    "StoreKind",
+    "render",
+]