manuscripta 0.1.0__tar.gz

manuscripta-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Asterios Raptis
+
+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.

manuscripta-0.1.0/PKG-INFO

@@ -0,0 +1,199 @@
+Metadata-Version: 2.4
+Name: manuscripta
+Version: 0.1.0
+Summary: Book production pipeline for authors and self-publishers. Multi-format export (PDF, EPUB, DOCX, HTML, Markdown), audiobook generation, translation, and manuscript tooling.
+License-Expression: MIT
+License-File: LICENSE
+Keywords: book,publishing,pandoc,epub,audiobook,self-publishing,kdp
+Author: Asterios Raptis
+Author-email: asteri.raptis@gmail.com
+Requires-Python: >=3.11,<4.0
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Topic :: Text Processing :: Markup :: Markdown
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Dist: beautifulsoup4 (>=4.14.3,<5.0.0)
+Requires-Dist: ebooklib (>=0.20,<0.21)
+Requires-Dist: edge-tts (>=7.2.7,<8.0.0)
+Requires-Dist: ftfy (>=6.3.1,<7.0.0)
+Requires-Dist: pandas (>=2.3.2,<3.0.0)
+Requires-Dist: pillow (>=11.2.1,<12.0.0)
+Requires-Dist: pymupdf (>=1.26.4,<2.0.0)
+Requires-Dist: python-dotenv (>=1.1.0,<2.0.0)
+Requires-Dist: pyyaml (>=6.0.2,<7.0.0)
+Requires-Dist: questionary (>=2.1.1,<3.0.0)
+Requires-Dist: requests (>=2.32.5,<3.0.0)
+Requires-Dist: toml (>=0.10.2,<0.11.0)
+Project-URL: Homepage, https://github.com/astrapi69/manuscripta
+Project-URL: Issues, https://github.com/astrapi69/manuscripta/issues
+Project-URL: Repository, https://github.com/astrapi69/manuscripta
+Description-Content-Type: text/markdown
+
+# manuscripta
+
+Book production pipeline for authors and self-publishers.
+
+Multi-format export (PDF, EPUB, DOCX, HTML, Markdown), audiobook generation, translation, and manuscript tooling, powered by Pandoc.
+
+## Installation
+
+```bash
+pip install manuscripta
+```
+
+Or with Poetry:
+
+```bash
+poetry add manuscripta
+```
+
+## Requirements
+
+- Python 3.11+
+- [Pandoc](https://pandoc.org/installing.html) installed and available on PATH
+- For audiobook generation: internet connection (Edge TTS) or local TTS engine
+
+## Quick Start
+
+Inside your book repository root:
+
+```bash
+# Export to PDF
+export-pdf
+
+# Export to EPUB with cover
+export-ewc --cover assets/covers/cover.jpg
+
+# Export all formats
+export-all
+
+# Safe export (no source modifications, good for drafts)
+export-pdf-safe
+
+# Generate audiobook
+manuscripta-audiobook --engine edge --voice en-US-JennyNeural
+
+# Initialize a new book project
+manuscripta-init
+```
+
+## Book Repository Structure
+
+Each book repository should follow this layout:
+
+```
+my-book/
+  manuscript/
+    front-matter/
+      toc.md
+      toc-print.md
+      foreword.md
+      preface.md
+    chapters/
+      01-chapter-one.md
+      02-chapter-two.md
+    back-matter/
+      epilogue.md
+      glossary.md
+      acknowledgments.md
+      about-the-author.md
+      bibliography.md
+      imprint.md
+  config/
+    metadata.yaml
+    export-settings.yaml
+    voice-settings.yaml
+  assets/
+    covers/
+    images/
+    fonts/
+    templates/
+  output/
+  pyproject.toml
+```
+
+## Configuration
+
+### export-settings.yaml
+
+Controls output formats, TOC behavior, and section ordering per book type (ebook, paperback, hardcover, audiobook).
+
+### voice-settings.yaml
+
+TTS configuration: language, voice, and sections to skip during audio generation.
+
+### metadata.yaml
+
+Pandoc metadata: title, author, date, language.
+
+## Available Commands
+
+### Export
+
+| Command | Description |
+|---------|-------------|
+| `export-pdf` / `export-p` | Export PDF |
+| `export-epub` / `export-e` | Export EPUB |
+| `export-docx` / `export-d` | Export DOCX |
+| `export-html` / `export-h` | Export HTML |
+| `export-md` | Export Markdown |
+| `export-all` | Export all formats |
+| `export-all-with-cover` | Export all with cover |
+| `export-pvp` | Print version (paperback) |
+| `export-pvh` | Print version (hardcover) |
+
+All export commands have a `-safe` variant (e.g. `export-pdf-safe`) that skips source preprocessing for fast, non-destructive draft builds.
+
+### Audiobook
+
+| Command | Description |
+|---------|-------------|
+| `manuscripta-audiobook` | Generate MP3 audiobook |
+
+### Translation
+
+| Command | Description |
+|---------|-------------|
+| `translate-en-de` | English to German (DeepL) |
+| `translate-de-en` | German to English (DeepL) |
+| `translate-book-en-de` | English to German (LMStudio) |
+| `translate-book-de-en` | German to English (LMStudio) |
+
+### Project Management
+
+| Command | Description |
+|---------|-------------|
+| `manuscripta-init` | Initialize new book project |
+| `create-chapters` | Create chapter files |
+| `reorder-chapters` | Reorder and rename chapters |
+| `manuscripta-tag` | Generate release tag message |
+
+## Module Structure
+
+```
+manuscripta/
+  export/        # PDF, EPUB, DOCX, HTML, Markdown export
+  audiobook/     # TTS-based audiobook generation
+    tts/         # Pluggable TTS backends (Edge, gTTS, pyttsx3, ElevenLabs)
+  translation/   # DeepL and LMStudio translation
+  markdown/      # Markdown processing (quotes, links, emojis, TOC)
+  paths/         # Path conversion (absolute/relative, image tags)
+  images/        # Image conversion, generation, injection
+  project/       # Project init, chapters, metadata, tagging
+  config/        # Config file loading
+  enums/         # Book type enum
+  utils/         # Pandoc batch, git cache, bulk operations
+  data/          # Emoji/symbol maps, JSON data files
+```
+
+## Companion Tools
+
+- [manuscript-tools](https://pypi.org/project/manuscript-tools/) - Validation, sanitization and metrics for Markdown manuscripts. Install separately for linting capabilities.
+
+## License
+
+MIT
+

manuscripta-0.1.0/README.md

@@ -0,0 +1,164 @@
+# manuscripta
+
+Book production pipeline for authors and self-publishers.
+
+Multi-format export (PDF, EPUB, DOCX, HTML, Markdown), audiobook generation, translation, and manuscript tooling, powered by Pandoc.
+
+## Installation
+
+```bash
+pip install manuscripta
+```
+
+Or with Poetry:
+
+```bash
+poetry add manuscripta
+```
+
+## Requirements
+
+- Python 3.11+
+- [Pandoc](https://pandoc.org/installing.html) installed and available on PATH
+- For audiobook generation: internet connection (Edge TTS) or local TTS engine
+
+## Quick Start
+
+Inside your book repository root:
+
+```bash
+# Export to PDF
+export-pdf
+
+# Export to EPUB with cover
+export-ewc --cover assets/covers/cover.jpg
+
+# Export all formats
+export-all
+
+# Safe export (no source modifications, good for drafts)
+export-pdf-safe
+
+# Generate audiobook
+manuscripta-audiobook --engine edge --voice en-US-JennyNeural
+
+# Initialize a new book project
+manuscripta-init
+```
+
+## Book Repository Structure
+
+Each book repository should follow this layout:
+
+```
+my-book/
+  manuscript/
+    front-matter/
+      toc.md
+      toc-print.md
+      foreword.md
+      preface.md
+    chapters/
+      01-chapter-one.md
+      02-chapter-two.md
+    back-matter/
+      epilogue.md
+      glossary.md
+      acknowledgments.md
+      about-the-author.md
+      bibliography.md
+      imprint.md
+  config/
+    metadata.yaml
+    export-settings.yaml
+    voice-settings.yaml
+  assets/
+    covers/
+    images/
+    fonts/
+    templates/
+  output/
+  pyproject.toml
+```
+
+## Configuration
+
+### export-settings.yaml
+
+Controls output formats, TOC behavior, and section ordering per book type (ebook, paperback, hardcover, audiobook).
+
+### voice-settings.yaml
+
+TTS configuration: language, voice, and sections to skip during audio generation.
+
+### metadata.yaml
+
+Pandoc metadata: title, author, date, language.
+
+## Available Commands
+
+### Export
+
+| Command | Description |
+|---------|-------------|
+| `export-pdf` / `export-p` | Export PDF |
+| `export-epub` / `export-e` | Export EPUB |
+| `export-docx` / `export-d` | Export DOCX |
+| `export-html` / `export-h` | Export HTML |
+| `export-md` | Export Markdown |
+| `export-all` | Export all formats |
+| `export-all-with-cover` | Export all with cover |
+| `export-pvp` | Print version (paperback) |
+| `export-pvh` | Print version (hardcover) |
+
+All export commands have a `-safe` variant (e.g. `export-pdf-safe`) that skips source preprocessing for fast, non-destructive draft builds.
+
+### Audiobook
+
+| Command | Description |
+|---------|-------------|
+| `manuscripta-audiobook` | Generate MP3 audiobook |
+
+### Translation
+
+| Command | Description |
+|---------|-------------|
+| `translate-en-de` | English to German (DeepL) |
+| `translate-de-en` | German to English (DeepL) |
+| `translate-book-en-de` | English to German (LMStudio) |
+| `translate-book-de-en` | German to English (LMStudio) |
+
+### Project Management
+
+| Command | Description |
+|---------|-------------|
+| `manuscripta-init` | Initialize new book project |
+| `create-chapters` | Create chapter files |
+| `reorder-chapters` | Reorder and rename chapters |
+| `manuscripta-tag` | Generate release tag message |
+
+## Module Structure
+
+```
+manuscripta/
+  export/        # PDF, EPUB, DOCX, HTML, Markdown export
+  audiobook/     # TTS-based audiobook generation
+    tts/         # Pluggable TTS backends (Edge, gTTS, pyttsx3, ElevenLabs)
+  translation/   # DeepL and LMStudio translation
+  markdown/      # Markdown processing (quotes, links, emojis, TOC)
+  paths/         # Path conversion (absolute/relative, image tags)
+  images/        # Image conversion, generation, injection
+  project/       # Project init, chapters, metadata, tagging
+  config/        # Config file loading
+  enums/         # Book type enum
+  utils/         # Pandoc batch, git cache, bulk operations
+  data/          # Emoji/symbol maps, JSON data files
+```
+
+## Companion Tools
+
+- [manuscript-tools](https://pypi.org/project/manuscript-tools/) - Validation, sanitization and metrics for Markdown manuscripts. Install separately for linting capabilities.
+
+## License
+
+MIT

manuscripta-0.1.0/pyproject.toml

@@ -0,0 +1,187 @@
+[project]
+name = "manuscripta"
+version = "0.1.0"
+description = "Book production pipeline for authors and self-publishers. Multi-format export (PDF, EPUB, DOCX, HTML, Markdown), audiobook generation, translation, and manuscript tooling."
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.11,<4.0"
+keywords = ["book", "publishing", "pandoc", "epub", "audiobook", "self-publishing", "kdp"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: End Users/Desktop",
+    "Topic :: Text Processing :: Markup :: Markdown",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+]
+
+[[project.authors]]
+name = "Asterios Raptis"
+email = "asteri.raptis@gmail.com"
+
+[project.urls]
+Homepage = "https://github.com/astrapi69/manuscripta"
+Repository = "https://github.com/astrapi69/manuscripta"
+Issues = "https://github.com/astrapi69/manuscripta/issues"
+
+[project.scripts]
+# --- Main commands ---
+manuscripta-export = "manuscripta.export.book:main"
+manuscripta-export-comic = "manuscripta.export.comic:main"
+manuscripta-audiobook = "manuscripta.audiobook.generator:main"
+manuscripta-init = "manuscripta.project.init:main"
+manuscripta-tag = "manuscripta.project.tag_message:main"
+
+# --- Export shortcuts ---
+export-shortcuts = "manuscripta.export.shortcuts:main"
+export-epub = "manuscripta.export.shortcuts:export_epub"
+export-epub2 = "manuscripta.export.shortcuts:export_epub2"
+export-e = "manuscripta.export.shortcuts:export_epub"
+export-e2 = "manuscripta.export.shortcuts:export_epub2"
+export-epub-with-cover = "manuscripta.export.shortcuts:export_epub_with_cover"
+export-epub2-with-cover = "manuscripta.export.shortcuts:export_epub2_with_cover"
+export-ewc = "manuscripta.export.shortcuts:export_epub_with_cover"
+export-e2wc = "manuscripta.export.shortcuts:export_epub2_with_cover"
+export-print-version-epub = "manuscripta.export.shortcuts:export_print_version_epub"
+export-pve = "manuscripta.export.shortcuts:export_print_version_epub"
+export-print-version-paperback = "manuscripta.export.shortcuts:export_print_version_paperback"
+export-pvp = "manuscripta.export.shortcuts:export_print_version_paperback"
+export-print-version-hardcover = "manuscripta.export.shortcuts:export_print_version_hardcover"
+export-pvh = "manuscripta.export.shortcuts:export_print_version_hardcover"
+export-markdown = "manuscripta.export.shortcuts:export_markdown"
+export-md = "manuscripta.export.shortcuts:export_markdown"
+export-pdf = "manuscripta.export.shortcuts:export_pdf"
+export-p = "manuscripta.export.shortcuts:export_pdf"
+export-docx = "manuscripta.export.shortcuts:export_docx"
+export-d = "manuscripta.export.shortcuts:export_docx"
+export-html = "manuscripta.export.shortcuts:export_html"
+export-h = "manuscripta.export.shortcuts:export_html"
+export-all-with-cover = "manuscripta.export.shortcuts:export_all_formats_with_cover"
+export-all = "manuscripta.export.shortcuts:export_all_formats"
+# Safe shortcuts (skip Step 1 & 4)
+export-pdf-safe = "manuscripta.export.shortcuts:export_pdf_safe"
+export-ps = "manuscripta.export.shortcuts:export_pdf_safe"
+export-epub-safe = "manuscripta.export.shortcuts:export_epub_safe"
+export-es = "manuscripta.export.shortcuts:export_epub_safe"
+export-docx-safe = "manuscripta.export.shortcuts:export_docx_safe"
+export-ds = "manuscripta.export.shortcuts:export_docx_safe"
+export-markdown-safe = "manuscripta.export.shortcuts:export_markdown_safe"
+export-mds = "manuscripta.export.shortcuts:export_markdown_safe"
+export-html-safe = "manuscripta.export.shortcuts:export_html_safe"
+export-hs = "manuscripta.export.shortcuts:export_html_safe"
+export-print-version-paperback-safe = "manuscripta.export.shortcuts:export_print_version_paperback_safe"
+export-pvps = "manuscripta.export.shortcuts:export_print_version_paperback_safe"
+export-print-version-hardcover-safe = "manuscripta.export.shortcuts:export_print_version_hardcover_safe"
+export-pvhs = "manuscripta.export.shortcuts:export_print_version_hardcover_safe"
+
+# --- Comic shortcuts ---
+export-comic-html = "manuscripta.export.shortcuts_comic:export_comic_html"
+export-comic-pdf = "manuscripta.export.shortcuts_comic:export_comic_pdf"
+
+# --- Init shortcuts ---
+update-mdv = "manuscripta.project.shortcuts_init:run_update_metadata_values"
+init-bp = "manuscripta.project.shortcuts_init:run_init_book_project"
+
+# --- Markdown tools ---
+fix-german-quotes = "manuscripta.markdown.german_quotes:main"
+replace-md-bullet-points = "manuscripta.markdown.bullet_points:main"
+unbold-md-headers = "manuscripta.markdown.unbold_headers:main"
+replace-emojis = "manuscripta.markdown.emojis:main"
+
+# --- Translation (DeepL) ---
+translate = "manuscripta.translation.shortcuts:translate"
+translate-de-es = "manuscripta.translation.shortcuts:translate_manuscript_from_german_to_spanish"
+translate-en-es = "manuscripta.translation.shortcuts:translate_manuscript_from_english_to_spanish"
+translate-en-de = "manuscripta.translation.shortcuts:translate_manuscript_to_german"
+translate-de-en = "manuscripta.translation.shortcuts:translate_manuscript_from_german_to_english"
+translate-book-deepl = "manuscripta.translation.deepl:main"
+
+# --- Translation (LMStudio) ---
+translate-book = "manuscripta.translation.lmstudio:main"
+translate-book-lmstudio = "manuscripta.translation.lmstudio:main"
+translate-book-en-es = "manuscripta.translation.shortcuts_lms:translate_manuscript_from_english_to_spanish"
+translate-book-en-de = "manuscripta.translation.shortcuts_lms:translate_manuscript_from_english_to_german"
+translate-book-en-fr = "manuscripta.translation.shortcuts_lms:translate_manuscript_from_english_to_french"
+translate-book-de-en = "manuscripta.translation.shortcuts_lms:translate_manuscript_from_german_to_english"
+
+# --- Utilities ---
+full-export = "manuscripta.export.book:main"
+generate-audiobook = "manuscripta.audiobook.generator:main"
+reorder-chapters = "manuscripta.project.reorder:main"
+make-tag-message = "manuscripta.project.tag_message:main"
+bulk-change-ext = "manuscripta.utils.bulk_extension:main"
+convert-images = "manuscripta.images.convert:main"
+generate-images = "manuscripta.images.generate:main"
+generate-images-deepai = "manuscripta.images.generate_deepai:main"
+inject-images = "manuscripta.images.inject:main"
+pandoc-batch = "manuscripta.utils.pandoc_batch:main"
+clean-git-cache = "manuscripta.utils.git_cache:main"
+create-chapters = "manuscripta.project.chapters:main"
+update-metadata-values = "manuscripta.project.metadata:main"
+convert-paths-to-absolute = "manuscripta.paths.to_absolute:main"
+convert-paths-to-relative = "manuscripta.paths.to_relative:main"
+print-version-build = "manuscripta.export.print_version:main"
+strip-links = "manuscripta.markdown.strip_links:main"
+normalize-toc = "manuscripta.markdown.normalize_toc:main"
+
+[tool.poetry.dependencies]
+python = ">=3.11,<4.0"
+pandas = "^2.3.2"
+python-dotenv = "^1.1.0"
+requests = "^2.32.5"
+pillow = "^11.2.1"
+pyyaml = "^6.0.2"
+toml = "^0.10.2"
+ftfy = "^6.3.1"
+questionary = "^2.1.1"
+pymupdf = "^1.26.4"
+edge-tts = "^7.2.7"
+ebooklib = "^0.20"
+beautifulsoup4 = "^4.14.3"
+
+[tool.poetry.group.dev.dependencies]
+hypothesis = "^6.138.13"
+types-pyyaml = "^6.0.12.20250915"
+types-toml = "^0.10.8.20240310"
+ruff = "^0.14.0"
+black = "^25.9.0"
+codespell = "^2.4.1"
+pre-commit = "^4.3.0"
+types-requests = "^2.32.4.20250913"
+mypy = "^1.11"
+pytest-cov = "^4.1.0"
+
+[tool.poetry.group.test.dependencies]
+hypothesis = ">=6,<7"
+pytest = "^8.2"
+pytest-mock = "^3.10.0"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "--cov=src/manuscripta --cov-report=term-missing"
+pythonpath = ["src"]
+
+[build-system]
+requires = ["poetry-core>=2.0.0,<3.0.0"]
+build-backend = "poetry.core.masonry.api"
+
+[tool.mypy]
+python_version = "3.11"
+ignore_missing_imports = true
+no_implicit_optional = false
+check_untyped_defs = false
+warn_unused_ignores = false
+allow_redefinition = true
+
+[[tool.mypy.overrides]]
+module = "tests.*"
+disallow_untyped_defs = false
+check_untyped_defs = false
+
+[tool.ruff]
+fix = true
+unsafe-fixes = true
+
+[tool.codespell]
+ignore-words-list = "prozess"

manuscripta-0.1.0/src/manuscripta/__init__.py

@@ -0,0 +1,3 @@
+"""manuscripta - Book production pipeline for authors and self-publishers."""
+
+__version__ = "0.1.0"