docs2epub 0.1.0__py3-none-any.whl → 0.1.1__py3-none-any.whl

docs2epub/__init__.py

@@ -2,4 +2,4 @@ __all__ = [
   "__version__",
 ]
 
-__version__ = "0.1.0"
+__version__ = "0.1.1"

docs2epub/cli.py

@@ -14,11 +14,33 @@ def _build_parser() -> argparse.ArgumentParser:
     description="Turn documentation sites into an EPUB (Kindle-friendly).",
   )
 
+  # Short positional form (for uvx):
+  #   docs2epub <START_URL> <OUT.epub>
   p.add_argument(
-    "--start-url",
-    required=True,
+    "start_url_pos",
+    nargs="?",
     help="Starting URL for scraping (initially: Docusaurus docs page).",
   )
+  p.add_argument(
+    "out_pos",
+    nargs="?",
+    help="Output EPUB file path.",
+  )
+
+  # Flag form (more explicit):
+  p.add_argument(
+    "--start-url",
+    dest="start_url",
+    default=None,
+    help="Starting URL for scraping (overrides positional start_url).",
+  )
+  p.add_argument(
+    "--out",
+    dest="out",
+    default=None,
+    help="Output EPUB file path (overrides positional out).",
+  )
+
   p.add_argument(
     "--base-url",
     default=None,
@@ -40,20 +62,23 @@ def _build_parser() -> argparse.ArgumentParser:
     help="Output format. Default: epub2 (Kindle-friendly).",
   )
 
-  p.add_argument(
-    "--out",
-    required=True,
-    help="Output EPUB file path.",
-  )
-
   return p
 
 
 def main(argv: list[str] | None = None) -> int:
   args = _build_parser().parse_args(argv)
 
+  start_url = args.start_url or args.start_url_pos
+  out_value = args.out or args.out_pos
+
+  if not start_url or not out_value:
+    raise SystemExit(
+      "Usage: docs2epub <START_URL> <OUT.epub> --title ... --author ...\n"
+      "(or use --start-url/--out flags)"
+    )
+
   options = DocusaurusNextOptions(
-    start_url=args.start_url,
+    start_url=start_url,
     base_url=args.base_url,
     max_pages=args.max_pages,
     sleep_s=args.sleep_s,
@@ -64,11 +89,12 @@ def main(argv: list[str] | None = None) -> int:
     raise SystemExit("No chapters scraped (did not find article content).")
 
   out_path: Path
+  out_path_value = Path(out_value)
 
   if args.format == "epub2":
     out_path = build_epub2_with_pandoc(
       chapters=chapters,
-      out_file=Path(args.out),
+      out_file=out_path_value,
       title=args.title,
       author=args.author,
       language=args.language,
@@ -86,7 +112,7 @@ def main(argv: list[str] | None = None) -> int:
 
     out_path = build_epub(
       chapters=chapters,
-      out_file=Path(args.out),
+      out_file=out_path_value,
       meta=meta,
     )
 

{docs2epub-0.1.0.dist-info → docs2epub-0.1.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: docs2epub
-Version: 0.1.0
+Version: 0.1.1
 Summary: Turn documentation sites into an EPUB (Kindle-friendly).
 Author: Breno Brito
 License: MIT
@@ -31,6 +31,16 @@ uv run docs2epub --help
 
 ## Usage
 
+### uvx (no install)
+
+```bash
+uvx docs2epub \
+  https://www.techinterviewhandbook.org/software-engineering-interview-guide/ \
+  tech-interview-handbook.epub \
+  --title "Tech Interview Handbook" \
+  --author "Yangshun Tay"
+```
+
 ### Docusaurus “Next” crawl
 
 ```bash

{docs2epub-0.1.0.dist-info → docs2epub-0.1.1.dist-info}/RECORD

@@ -1,11 +1,11 @@
-docs2epub/__init__.py,sha256=cQZgZRibboC-fCxb4OVzIvaNHJerdDGBpi_kCIoPHj4,54
-docs2epub/cli.py,sha256=8r-nxAMA-UOs4GOnFTpa6AdfoKICL9JbZMwtOQ_bD18,2365
+docs2epub/__init__.py,sha256=zCC51i_uxiMh2wmZYBMWo4zCNEe8sfrk0dhrvo6eZ8E,54
+docs2epub/cli.py,sha256=wq0oQP2W9p_eRR9P0W1AvZTn-yrutxfm7u6qU2JCcRA,3056
 docs2epub/docusaurus_next.py,sha256=OybL3KPwDZvp2sOL3locE374Zb80M1kubx81SH2GxgQ,3378
 docs2epub/epub.py,sha256=OsPWcPGTgazAeNpWASIE6e4HQ5ILQr2VFO1-Aj3y1kg,2986
 docs2epub/kindle_html.py,sha256=iymXlYFDfEIRIKC3vaepV_K-SFEvCPpAI5FESj7udOU,2153
 docs2epub/model.py,sha256=uL7uwbG6yU0bEGpSFxxIv2pcZHQR9cs2prfqk5iNQwc,160
 docs2epub/pandoc_epub2.py,sha256=m_9yJeeciyeoXMx5bVJs2qIutGDXifvd8TtFh2DRm-k,2335
-docs2epub-0.1.0.dist-info/METADATA,sha256=ex5GH-1rxlvgzIxqht1Tdv5leQeRXB1pZnkUrS7M5Hc,1490
-docs2epub-0.1.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-docs2epub-0.1.0.dist-info/entry_points.txt,sha256=DHK4mzthrIXUvM8Y8Vo_3jG2IhegEDDM7T9CvCkUtvw,49
-docs2epub-0.1.0.dist-info/RECORD,,
+docs2epub-0.1.1.dist-info/METADATA,sha256=QJ8YaNtyyUqoSf8dYMeT9bNAmZ3RCmb2s74_VYvbdvM,1718
+docs2epub-0.1.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+docs2epub-0.1.1.dist-info/entry_points.txt,sha256=DHK4mzthrIXUvM8Y8Vo_3jG2IhegEDDM7T9CvCkUtvw,49
+docs2epub-0.1.1.dist-info/RECORD,,