ranobelib-python-sdk 0.2.0__tar.gz → 0.4.0__tar.gz

ranobelib_python_sdk-0.4.0/PKG-INFO

@@ -0,0 +1,113 @@
+Metadata-Version: 2.4
+Name: ranobelib-python-sdk
+Version: 0.4.0
+Summary: Async Python SDK for ranobelib.me: title metadata, chapter/volume downloads, and export to epub/fb2/txt/pdf
+Keywords: ranobelib,ranobe,novel,webnovel,epub,fb2,sdk
+Author: LLIJIYAPNIK
+Author-email: LLIJIYAPNIK <kas4wot@yandex.ru>
+License-Expression: MIT
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Dist: ebooklib>=0.20
+Requires-Dist: httpx>=0.27
+Requires-Dist: pydantic>=2.7
+Requires-Dist: rich>=15.0.0
+Requires-Dist: weasyprint>=69.0
+Requires-Python: >=3.11
+Project-URL: Homepage, https://github.com/LLIJIYAPNIK/ranobelib-python-sdk
+Project-URL: Repository, https://github.com/LLIJIYAPNIK/ranobelib-python-sdk
+Project-URL: Issues, https://github.com/LLIJIYAPNIK/ranobelib-python-sdk/issues
+Project-URL: Changelog, https://github.com/LLIJIYAPNIK/ranobelib-python-sdk/blob/main/CHANGELOG.md
+Description-Content-Type: text/markdown
+
+# ranobelib-python-sdk
+
+[![PyPI](https://img.shields.io/pypi/v/ranobelib-python-sdk)](https://pypi.org/project/ranobelib-python-sdk/)
+[![License: MIT](https://img.shields.io/github/license/LLIJIYAPNIK/ranobelib-python-sdk)](LICENSE)
+[![Python versions](https://img.shields.io/badge/python-3.11%20%7C%203.12%20%7C%203.13-blue)](pyproject.toml)
+[![CI](https://github.com/LLIJIYAPNIK/ranobelib-python-sdk/actions/workflows/ci.yml/badge.svg)](https://github.com/LLIJIYAPNIK/ranobelib-python-sdk/actions/workflows/ci.yml)
+[![Coverage Status](https://coveralls.io/repos/github/LLIJIYAPNIK/ranobelib-python-sdk/badge.svg?branch=main)](https://coveralls.io/github/LLIJIYAPNIK/ranobelib-python-sdk?branch=main)
+[![Docs](https://github.com/LLIJIYAPNIK/ranobelib-python-sdk/actions/workflows/docs.yml/badge.svg)](https://github.com/LLIJIYAPNIK/ranobelib-python-sdk/actions/workflows/docs.yml)
+
+Async Python SDK for [ranobelib.me](https://ranobelib.me): fetch title metadata, download
+chapters and volumes, and export to epub, fb2, txt, or pdf.
+
+The SDK talks to the undocumented but open JSON API behind the site (`api.cdnlibs.org`,
+part of the lib.social network) instead of scraping HTML.
+
+> **Status:** all the calls in the quickstart below are implemented — metadata, table of
+> contents, single/bulk chapter and volume downloads, whole-title bulk download, translation
+> selection, and export to
+> `"txt"`, `"fb2"`, `"epub"`, or `"pdf"` (cover + in-chapter illustrations embedded in
+> epub/pdf). Raw API responses are cached to disk, and the underlying client bounds
+> concurrency, paces requests, and retries 429/5xx with backoff. `fmt="pdf"` needs
+> WeasyPrint's native dependencies (Pango/cairo/GTK3) installed on the system — `pip
+> install`/`uv add` alone doesn't guarantee that on every platform; without them,
+> `export(fmt="pdf")` raises the same "unknown format" error the other three formats don't.
+> Authorization (private/18+/paid content) is out of scope — see `CLAUDE.md` for the full
+> architecture and design decisions behind all of this.
+
+## Installation
+
+```bash
+uv add ranobelib-python-sdk
+```
+
+or
+
+```bash
+pip install ranobelib-python-sdk
+```
+
+Requires Python 3.11+.
+
+## Quickstart
+
+```python
+from ranobelib import RanobeLib
+
+async with RanobeLib("https://ranobelib.me/ru/book/6712--high-school-dxd-novel") as lib:
+    info = await lib.get_info()
+    toc = await lib.get_table_of_contents()
+
+    chapter = await lib.get_chapter(volume=6, number="51.6")
+    volume = await lib.get_volume(volume=6)
+
+    chapters = await lib.get_chapters([(6, "51.6"), (6, "52")])
+    volumes = await lib.get_volumes([1, 2, 3])
+
+    translations = await lib.get_translations(volume=6, number="51.6")
+    chapter = await lib.get_chapter(volume=6, number="51.6", branch_id=...)
+
+    all_volumes = await lib.download_title(translation_index=0, chapter_delay=0.5)
+
+    await lib.export(chapters, fmt="epub", path="output.epub")
+```
+
+This is the full current public API — everything above is implemented and works today.
+
+## Examples
+
+Complete, runnable scripts for every feature above — title metadata, table of contents,
+single/bulk chapter and volume downloads, translation selection, whole-title bulk download,
+disk caching, export to all four formats, and error handling — live in
+**[`examples/`](examples/)**, one heavily commented file per feature. Start there for
+copy-pasteable code.
+
+## Documentation
+
+Full API reference and guides: **<https://LLIJIYAPNIK.github.io/ranobelib-python-sdk/>**
+(built with `mkdocs-material` + `mkdocstrings`, deployed on push to `main`). `CLAUDE.md`
+documents the full architecture, public API contract, and the reasoning behind the SDK's
+design decisions. [`CHANGELOG.md`](CHANGELOG.md) lists what changed in each release.
+
+## License
+
+MIT — see [LICENSE](LICENSE).

ranobelib_python_sdk-0.4.0/README.md

@@ -0,0 +1,84 @@
+# ranobelib-python-sdk
+
+[![PyPI](https://img.shields.io/pypi/v/ranobelib-python-sdk)](https://pypi.org/project/ranobelib-python-sdk/)
+[![License: MIT](https://img.shields.io/github/license/LLIJIYAPNIK/ranobelib-python-sdk)](LICENSE)
+[![Python versions](https://img.shields.io/badge/python-3.11%20%7C%203.12%20%7C%203.13-blue)](pyproject.toml)
+[![CI](https://github.com/LLIJIYAPNIK/ranobelib-python-sdk/actions/workflows/ci.yml/badge.svg)](https://github.com/LLIJIYAPNIK/ranobelib-python-sdk/actions/workflows/ci.yml)
+[![Coverage Status](https://coveralls.io/repos/github/LLIJIYAPNIK/ranobelib-python-sdk/badge.svg?branch=main)](https://coveralls.io/github/LLIJIYAPNIK/ranobelib-python-sdk?branch=main)
+[![Docs](https://github.com/LLIJIYAPNIK/ranobelib-python-sdk/actions/workflows/docs.yml/badge.svg)](https://github.com/LLIJIYAPNIK/ranobelib-python-sdk/actions/workflows/docs.yml)
+
+Async Python SDK for [ranobelib.me](https://ranobelib.me): fetch title metadata, download
+chapters and volumes, and export to epub, fb2, txt, or pdf.
+
+The SDK talks to the undocumented but open JSON API behind the site (`api.cdnlibs.org`,
+part of the lib.social network) instead of scraping HTML.
+
+> **Status:** all the calls in the quickstart below are implemented — metadata, table of
+> contents, single/bulk chapter and volume downloads, whole-title bulk download, translation
+> selection, and export to
+> `"txt"`, `"fb2"`, `"epub"`, or `"pdf"` (cover + in-chapter illustrations embedded in
+> epub/pdf). Raw API responses are cached to disk, and the underlying client bounds
+> concurrency, paces requests, and retries 429/5xx with backoff. `fmt="pdf"` needs
+> WeasyPrint's native dependencies (Pango/cairo/GTK3) installed on the system — `pip
+> install`/`uv add` alone doesn't guarantee that on every platform; without them,
+> `export(fmt="pdf")` raises the same "unknown format" error the other three formats don't.
+> Authorization (private/18+/paid content) is out of scope — see `CLAUDE.md` for the full
+> architecture and design decisions behind all of this.
+
+## Installation
+
+```bash
+uv add ranobelib-python-sdk
+```
+
+or
+
+```bash
+pip install ranobelib-python-sdk
+```
+
+Requires Python 3.11+.
+
+## Quickstart
+
+```python
+from ranobelib import RanobeLib
+
+async with RanobeLib("https://ranobelib.me/ru/book/6712--high-school-dxd-novel") as lib:
+    info = await lib.get_info()
+    toc = await lib.get_table_of_contents()
+
+    chapter = await lib.get_chapter(volume=6, number="51.6")
+    volume = await lib.get_volume(volume=6)
+
+    chapters = await lib.get_chapters([(6, "51.6"), (6, "52")])
+    volumes = await lib.get_volumes([1, 2, 3])
+
+    translations = await lib.get_translations(volume=6, number="51.6")
+    chapter = await lib.get_chapter(volume=6, number="51.6", branch_id=...)
+
+    all_volumes = await lib.download_title(translation_index=0, chapter_delay=0.5)
+
+    await lib.export(chapters, fmt="epub", path="output.epub")
+```
+
+This is the full current public API — everything above is implemented and works today.
+
+## Examples
+
+Complete, runnable scripts for every feature above — title metadata, table of contents,
+single/bulk chapter and volume downloads, translation selection, whole-title bulk download,
+disk caching, export to all four formats, and error handling — live in
+**[`examples/`](examples/)**, one heavily commented file per feature. Start there for
+copy-pasteable code.
+
+## Documentation
+
+Full API reference and guides: **<https://LLIJIYAPNIK.github.io/ranobelib-python-sdk/>**
+(built with `mkdocs-material` + `mkdocstrings`, deployed on push to `main`). `CLAUDE.md`
+documents the full architecture, public API contract, and the reasoning behind the SDK's
+design decisions. [`CHANGELOG.md`](CHANGELOG.md) lists what changed in each release.
+
+## License
+
+MIT — see [LICENSE](LICENSE).

{ranobelib_python_sdk-0.2.0 → ranobelib_python_sdk-0.4.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "ranobelib-python-sdk"
-version = "0.2.0"
+version = "0.4.0"
 description = "Async Python SDK for ranobelib.me: title metadata, chapter/volume downloads, and export to epub/fb2/txt/pdf"
 readme = "README.md"
 license = "MIT"
@@ -29,6 +29,7 @@ dependencies = [
     "ebooklib>=0.20",
     "httpx>=0.27",
     "pydantic>=2.7",
+    "rich>=15.0.0",
     "weasyprint>=69.0",
 ]
 
@@ -40,6 +41,7 @@ email = "kas4wot@yandex.ru"
 Homepage = "https://github.com/LLIJIYAPNIK/ranobelib-python-sdk"
 Repository = "https://github.com/LLIJIYAPNIK/ranobelib-python-sdk"
 Issues = "https://github.com/LLIJIYAPNIK/ranobelib-python-sdk/issues"
+Changelog = "https://github.com/LLIJIYAPNIK/ranobelib-python-sdk/blob/main/CHANGELOG.md"
 
 [build-system]
 requires = ["uv_build>=0.11.26,<0.12.0"]

{ranobelib_python_sdk-0.2.0 → ranobelib_python_sdk-0.4.0}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "ranobelib-python-sdk"
-version = "0.2.0"
+version = "0.4.0"
 description = "Async Python SDK for ranobelib.me: title metadata, chapter/volume downloads, and export to epub/fb2/txt/pdf"
 readme = "README.md"
 license = "MIT"
@@ -24,6 +24,7 @@ dependencies = [
     "ebooklib>=0.20",
     "httpx>=0.27",
     "pydantic>=2.7",
+    "rich>=15.0.0",
     "weasyprint>=69.0",
 ]
 
@@ -31,6 +32,7 @@ dependencies = [
 Homepage = "https://github.com/LLIJIYAPNIK/ranobelib-python-sdk"
 Repository = "https://github.com/LLIJIYAPNIK/ranobelib-python-sdk"
 Issues = "https://github.com/LLIJIYAPNIK/ranobelib-python-sdk/issues"
+Changelog = "https://github.com/LLIJIYAPNIK/ranobelib-python-sdk/blob/main/CHANGELOG.md"
 
 [build-system]
 requires = ["uv_build>=0.11.26,<0.12.0"]

{ranobelib_python_sdk-0.2.0 → ranobelib_python_sdk-0.4.0}/src/ranobelib/__init__.py

@@ -13,6 +13,7 @@ from ranobelib.exceptions import (
 )
 from ranobelib.models import Chapter, ChapterBranch, Title, Volume
 from ranobelib.sdk import RanobeLib
+from ranobelib.sizing import chapter_size, volume_size
 
 __all__ = [
     "AmbiguousChapter",
@@ -29,4 +30,6 @@ __all__ = [
     "TitleNotFoundError",
     "Volume",
     "VolumeNotFoundError",
+    "chapter_size",
+    "volume_size",
 ]

ranobelib_python_sdk-0.4.0/src/ranobelib/console.py

@@ -0,0 +1,72 @@
+"""Console output for RanobeLib: progress bars and full-mode operation logging.
+
+Behind ``RanobeLib``'s ``verbosity`` parameter (``False`` by default, ``"progress_only"``,
+or ``"full"`` — see CLAUDE.md's roadmap entry for why these three, and why this prints
+directly via ``rich`` rather than going through ``logging``). ``Reporter`` is the single
+object that knows which of the three modes is active; every call site (``sdk.py``, the
+exporters) just calls ``log()``/``progress()`` unconditionally and lets ``Reporter`` decide
+whether that produces any output.
+"""
+
+from __future__ import annotations
+
+from collections.abc import Callable, Iterator
+from contextlib import contextmanager
+from typing import Literal
+
+from rich.console import Console
+from rich.progress import BarColumn, MofNCompleteColumn, Progress, TextColumn, TimeElapsedColumn
+
+Verbosity = Literal["full", "progress_only"] | Literal[False]
+"""``False``: silent. ``"progress_only"``: progress bars only. ``"full"``: progress bars
+plus a line logged for every title/chapters-list/chapter-content fetch (cache hit or API)."""
+
+
+class Reporter:
+    """Console output gated by a ``Verbosity`` level, backed by a single ``rich.Console``."""
+
+    def __init__(self, verbosity: Verbosity, *, console: Console | None = None) -> None:
+        """Initialize the reporter.
+
+        Args:
+            verbosity: The active output level.
+            console: Custom ``rich.console.Console`` to print through, e.g. one writing to
+                an in-memory stream for tests. Defaults to a new ``Console()`` (stdout) —
+                only constructed at all when ``verbosity`` isn't ``False``, so a silent
+                ``RanobeLib`` never touches the terminal.
+        """
+        self._verbosity = verbosity
+        if not verbosity:
+            self._console = None
+        else:
+            self._console = console if console is not None else Console()
+
+    def log(self, message: str) -> None:
+        """Print ``message``, only when verbosity is ``"full"``.
+
+        ``markup=False``: messages embed literal ``[cache]``/``[api]`` prefixes (see
+        ``sdk.py``'s choke points), which rich's default markup parsing would otherwise try
+        to interpret as style tags.
+        """
+        if self._verbosity == "full" and self._console is not None:
+            self._console.log(message, markup=False)
+
+    @contextmanager
+    def progress(self, description: str, total: int) -> Iterator[Callable[[], None]]:
+        """A progress bar shown for ``"progress_only"``/``"full"``, a no-op otherwise.
+
+        Yields a zero-argument callable: call it once per completed step.
+        """
+        if not self._verbosity or total == 0:
+            yield lambda: None
+            return
+
+        with Progress(
+            TextColumn("[progress.description]{task.description}"),
+            BarColumn(),
+            MofNCompleteColumn(),
+            TimeElapsedColumn(),
+            console=self._console,
+        ) as progress:
+            task_id = progress.add_task(description, total=total)
+            yield lambda: progress.advance(task_id)

{ranobelib_python_sdk-0.2.0 → ranobelib_python_sdk-0.4.0}/src/ranobelib/exporters/__init__.py

@@ -9,6 +9,7 @@ from __future__ import annotations
 
 import importlib
 import pkgutil
+from collections.abc import Callable
 from pathlib import Path
 from typing import ClassVar, Protocol, TypeVar, runtime_checkable
 
@@ -22,7 +23,14 @@ class Exporter(Protocol):
     format: ClassVar[str]
     """The registry key this exporter is selected by, e.g. ``"txt"``."""
 
-    async def export(self, title: Title, chapters: list[Chapter], output_path: Path) -> Path:
+    async def export(
+        self,
+        title: Title,
+        chapters: list[Chapter],
+        output_path: Path,
+        *,
+        on_chapter: Callable[[], None] | None = None,
+    ) -> Path:
         """Write ``chapters`` (in the given order) to ``output_path``.
 
         ``async`` since embedding illustrations (epub, pdf) requires downloading them —
@@ -33,6 +41,10 @@ class Exporter(Protocol):
             title: The chapters' parent title, for metadata (name, authors, ...).
             chapters: The chapters to include, in the order they should appear.
             output_path: Where to write the exported file.
+            on_chapter: Called once per chapter processed, if given — drives
+                ``RanobeLib.export()``'s progress bar (see CLAUDE.md's roadmap step 23).
+                For epub/pdf this covers the per-chapter embedding step, not the earlier
+                illustration-download step, which isn't itself progress-reported.
 
         Returns:
             ``output_path``, once the file has been written.

{ranobelib_python_sdk-0.2.0 → ranobelib_python_sdk-0.4.0}/src/ranobelib/exporters/epub.py

@@ -3,6 +3,7 @@
 from __future__ import annotations
 
 import html
+from collections.abc import Callable
 from pathlib import Path
 from typing import ClassVar
 
@@ -39,7 +40,14 @@ class EpubExporter:
         """
         self._transport = transport
 
-    async def export(self, title: Title, chapters: list[Chapter], output_path: Path) -> Path:
+    async def export(
+        self,
+        title: Title,
+        chapters: list[Chapter],
+        output_path: Path,
+        *,
+        on_chapter: Callable[[], None] | None = None,
+    ) -> Path:
         """Write ``chapters`` to ``output_path`` as an EPUB file.
 
         Downloads the title's cover and every image referenced in the chapters' content and
@@ -50,6 +58,8 @@ class EpubExporter:
             title: The chapters' parent title; supplies metadata, cover, and authors.
             chapters: The chapters to include, in the order they should appear.
             output_path: Where to write the ``.epub`` file.
+            on_chapter: Called once per chapter embedded, if given — after illustrations
+                have already been downloaded, see the ``Exporter`` protocol's docstring.
 
         Returns:
             ``output_path``.
@@ -107,6 +117,8 @@ class EpubExporter:
             book.add_item(doc)
             spine.append(doc)
             toc.append(doc)
+            if on_chapter is not None:
+                on_chapter()
 
         book.toc = toc
         book.add_item(epub.EpubNcx())

{ranobelib_python_sdk-0.2.0 → ranobelib_python_sdk-0.4.0}/src/ranobelib/exporters/fb2.py

@@ -4,6 +4,7 @@ from __future__ import annotations
 
 import datetime
 import xml.etree.ElementTree as ET
+from collections.abc import Callable
 from html.parser import HTMLParser
 from pathlib import Path
 from typing import ClassVar
@@ -126,7 +127,7 @@ def _build_description(title: Title) -> ET.Element:
     return description
 
 
-def _build_body(chapters: list[Chapter]) -> ET.Element:
+def _build_body(chapters: list[Chapter], on_chapter: Callable[[], None] | None) -> ET.Element:
     body = ET.Element(_tag("body"))
     for chapter in chapters:
         section = ET.SubElement(body, _tag("section"))
@@ -134,6 +135,8 @@ def _build_body(chapters: list[Chapter]) -> ET.Element:
         ET.SubElement(section_title, _tag("p")).text = chapter_heading(chapter)
         for paragraph in html_to_fb2_paragraphs(chapter.content or ""):
             section.append(paragraph)
+        if on_chapter is not None:
+            on_chapter()
     return body
 
 
@@ -143,20 +146,28 @@ class Fb2Exporter:
 
     format: ClassVar[str] = "fb2"
 
-    async def export(self, title: Title, chapters: list[Chapter], output_path: Path) -> Path:
+    async def export(
+        self,
+        title: Title,
+        chapters: list[Chapter],
+        output_path: Path,
+        *,
+        on_chapter: Callable[[], None] | None = None,
+    ) -> Path:
         """Write ``chapters`` to ``output_path`` as FB2 XML.
 
         Args:
             title: The chapters' parent title; supplies ``description`` metadata.
             chapters: The chapters to include, in the order they should appear.
             output_path: Where to write the ``.fb2`` file.
+            on_chapter: Called once per chapter written, if given.
 
         Returns:
             ``output_path``.
         """
         root = ET.Element(_tag("FictionBook"))
         root.append(_build_description(title))
-        root.append(_build_body(chapters))
+        root.append(_build_body(chapters, on_chapter))
 
         tree = ET.ElementTree(root)
         ET.indent(tree, space="  ")

{ranobelib_python_sdk-0.2.0 → ranobelib_python_sdk-0.4.0}/src/ranobelib/exporters/pdf.py

@@ -5,6 +5,7 @@ from __future__ import annotations
 import asyncio
 import base64
 import html
+from collections.abc import Callable
 from pathlib import Path
 from typing import ClassVar
 
@@ -98,13 +99,23 @@ if weasyprint is not None:
             """
             self._transport = transport
 
-        async def export(self, title: Title, chapters: list[Chapter], output_path: Path) -> Path:
+        async def export(
+            self,
+            title: Title,
+            chapters: list[Chapter],
+            output_path: Path,
+            *,
+            on_chapter: Callable[[], None] | None = None,
+        ) -> Path:
             """Write ``chapters`` to ``output_path`` as a PDF file.
 
             Args:
                 title: The chapters' parent title; supplies metadata, cover, and authors.
                 chapters: The chapters to include, in the order they should appear.
                 output_path: Where to write the ``.pdf`` file.
+                on_chapter: Called once per chapter rendered to HTML, if given — after
+                    illustrations have already been downloaded, see the ``Exporter``
+                    protocol's docstring.
 
             Returns:
                 ``output_path``.
@@ -135,9 +146,12 @@ if weasyprint is not None:
                 for url, data in images.items()
             }
 
-            body = _title_page_html(title, cover_data_uri) + "".join(
-                _chapter_html(chapter, url_to_data_uri) for chapter in chapters
-            )
+            chapter_html_parts = []
+            for chapter in chapters:
+                chapter_html_parts.append(_chapter_html(chapter, url_to_data_uri))
+                if on_chapter is not None:
+                    on_chapter()
+            body = _title_page_html(title, cover_data_uri) + "".join(chapter_html_parts)
             document = (
                 f"<html><head><meta charset='utf-8'><style>{_PAGE_CSS}</style></head>"
                 f"<body>{body}</body></html>"

{ranobelib_python_sdk-0.2.0 → ranobelib_python_sdk-0.4.0}/src/ranobelib/exporters/txt.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+from collections.abc import Callable
 from html.parser import HTMLParser
 from pathlib import Path
 from typing import ClassVar
@@ -69,13 +70,21 @@ class TxtExporter:
 
     format: ClassVar[str] = "txt"
 
-    async def export(self, title: Title, chapters: list[Chapter], output_path: Path) -> Path:
+    async def export(
+        self,
+        title: Title,
+        chapters: list[Chapter],
+        output_path: Path,
+        *,
+        on_chapter: Callable[[], None] | None = None,
+    ) -> Path:
         """Write ``chapters`` to ``output_path`` as plain text.
 
         Args:
             title: The chapters' parent title; only its name is used.
             chapters: The chapters to include, in the order they should appear.
             output_path: Where to write the ``.txt`` file.
+            on_chapter: Called once per chapter written, if given.
 
         Returns:
             ``output_path``.
@@ -84,6 +93,8 @@ class TxtExporter:
         for chapter in chapters:
             body = html_to_text(chapter.content or "")
             sections.append(f"{chapter_heading(chapter)}\n\n{body}")
+            if on_chapter is not None:
+                on_chapter()
 
         output_path.write_text("\n\n\n".join(sections) + "\n", encoding="utf-8")
         return output_path