Merge branch 'main' into main

Author: ebotiab

pdfly/cli.py

@@ -33,6 +33,7 @@ def version_callback(value: bool) -> None:
     help=(
         "pdfly is a pure-python cli application for manipulating PDF files."
     ),
+    rich_markup_mode="rich",  # Allows to pretty-print commands documentation
 )
 
 
@@ -44,7 +45,7 @@ def common(
     pass
 
 
-@entry_point.command(name="extract-images")  # type: ignore[misc]
+@entry_point.command(name="extract-images", help=pdfly.extract_images.__doc__)  # type: ignore[misc]
 def extract_images(
     pdf: Annotated[
         Path,
@@ -61,7 +62,7 @@ def extract_images(
     pdfly.extract_images.main(pdf)
 
 
-@entry_point.command(name="2-up")  # type: ignore[misc]
+@entry_point.command(name="2-up", help=pdfly.up2.__doc__)  # type: ignore[misc]
 def up2(
     pdf: Annotated[
         Path,
@@ -79,7 +80,7 @@ def up2(
     pdfly.up2.main(pdf, out)
 
 
-@entry_point.command(name="cat")  # type: ignore[misc]
+@entry_point.command(name="cat", help=pdfly.cat.__doc__)  # type: ignore[misc]
 def cat(
     filename: Annotated[
         Path,
@@ -129,7 +130,7 @@ def rm(
     )
 
 
-@entry_point.command(name="meta")  # type: ignore[misc]
+@entry_point.command(name="meta", help=pdfly.metadata.__doc__)  # type: ignore[misc]
 def metadata(
     pdf: Annotated[
         Path,
@@ -153,7 +154,7 @@ def metadata(
     pdfly.metadata.main(pdf, output)
 
 
-@entry_point.command(name="pagemeta")  # type: ignore[misc]
+@entry_point.command(name="pagemeta", help=pdfly.pagemeta.__doc__)  # type: ignore[misc]
 def pagemeta(
     pdf: Annotated[
         Path,
@@ -204,7 +205,7 @@ def extract_text(
         print(page.extract_text())
 
 
-@entry_point.command(name="compress")  # type: ignore[misc]
+@entry_point.command(name="compress", help=pdfly.compress.__doc__)  # type: ignore[misc]
 def compress(
     pdf: Annotated[
         Path,
@@ -228,7 +229,7 @@ def compress(
     pdfly.compress.main(pdf, output)
 
 
-@entry_point.command(name="x2pdf")  # type: ignore[misc]
+@entry_point.command(name="x2pdf", help=pdfly.x2pdf.__doc__)  # type: ignore[misc]
 def x2pdf(
     x: List[Path],
     output: Annotated[
@@ -242,12 +243,3 @@ def x2pdf(
     ],
 ) -> int:
     return pdfly.x2pdf.main(x, output)
-
-
-up2.__doc__ = pdfly.up2.__doc__
-extract_images.__doc__ = pdfly.extract_images.__doc__
-cat.__doc__ = pdfly.cat.__doc__
-metadata.__doc__ = pdfly.metadata.__doc__
-pagemeta.__doc__ = pdfly.pagemeta.__doc__
-compress.__doc__ = pdfly.compress.__doc__
-x2pdf.__doc__ = pdfly.x2pdf.__doc__