git: eba20a57733d - main - devel/py-argparse-manpage: Add py-argparse-manpage 4.6
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
Date: Thu, 05 Sep 2024 06:19:32 UTC
The branch main has been updated by sunpoet:
URL: https://cgit.FreeBSD.org/ports/commit/?id=eba20a57733da6482627fe49cf86a131fb58b546
commit eba20a57733da6482627fe49cf86a131fb58b546
Author: Po-Chuan Hsieh <sunpoet@FreeBSD.org>
AuthorDate: 2024-09-05 05:14:04 +0000
Commit: Po-Chuan Hsieh <sunpoet@FreeBSD.org>
CommitDate: 2024-09-05 06:11:19 +0000
devel/py-argparse-manpage: Add py-argparse-manpage 4.6
Avoid documenting your Python script arguments on two places! This is typically
done in an argparse.ArgumentParser help configuration (help=, description=,
etc.), and also in a manually crafted manual page.
The good thing about an ArgumentParser objects is that it actually provides a
traversable "tree-like" structure, with all the necessary info needed to
automatically generate documentation, for example in a groff typesetting system
(manual pages). And this is where this project can help.
There are two supported ways to generate the manual, either script it using the
installed command argparse-manpage, or via setup.py build automation (with a
slight bonus of automatic manual page installation with setup.py install).
---
devel/Makefile | 1 +
devel/py-argparse-manpage/Makefile | 25 +++++++++++++++++++++++++
devel/py-argparse-manpage/distinfo | 3 +++
devel/py-argparse-manpage/pkg-descr | 12 ++++++++++++
4 files changed, 41 insertions(+)
diff --git a/devel/Makefile b/devel/Makefile
index b5d9131c76b5..60915f1857a4 100644
--- a/devel/Makefile
+++ b/devel/Makefile
@@ -4370,6 +4370,7 @@
SUBDIR += py-argcomplete
SUBDIR += py-argh
SUBDIR += py-argparse
+ SUBDIR += py-argparse-manpage
SUBDIR += py-argparse_addons
SUBDIR += py-args
SUBDIR += py-ariadne
diff --git a/devel/py-argparse-manpage/Makefile b/devel/py-argparse-manpage/Makefile
new file mode 100644
index 000000000000..c2b12814ecd6
--- /dev/null
+++ b/devel/py-argparse-manpage/Makefile
@@ -0,0 +1,25 @@
+PORTNAME= argparse-manpage
+PORTVERSION= 4.6
+CATEGORIES= devel python
+MASTER_SITES= PYPI
+PKGNAMEPREFIX= ${PYTHON_PKGNAMEPREFIX}
+
+MAINTAINER= sunpoet@FreeBSD.org
+COMMENT= Build manual page from python's ArgumentParser object
+WWW= https://github.com/praiskup/argparse-manpage
+
+LICENSE= APACHE20
+LICENSE_FILE= ${WRKSRC}/LICENSE
+
+BUILD_DEPENDS= ${PYTHON_PKGNAMEPREFIX}packaging>=0:devel/py-packaging@${PY_FLAVOR} \
+ ${PYTHON_PKGNAMEPREFIX}setuptools>=0:devel/py-setuptools@${PY_FLAVOR} \
+ ${PY_TOMLI} \
+ ${PYTHON_PKGNAMEPREFIX}wheel>=0:devel/py-wheel@${PY_FLAVOR}
+RUN_DEPENDS= ${PY_TOMLI}
+
+USES= python
+USE_PYTHON= autoplist concurrent pep517
+
+NO_ARCH= yes
+
+.include <bsd.port.mk>
diff --git a/devel/py-argparse-manpage/distinfo b/devel/py-argparse-manpage/distinfo
new file mode 100644
index 000000000000..c091a5db3a15
--- /dev/null
+++ b/devel/py-argparse-manpage/distinfo
@@ -0,0 +1,3 @@
+TIMESTAMP = 1724084480
+SHA256 (argparse-manpage-4.6.tar.gz) = 0b659d70fd142876da41c2918bd6de4d027875720b0e4672d6443b51198dbb62
+SIZE (argparse-manpage-4.6.tar.gz) = 58674
diff --git a/devel/py-argparse-manpage/pkg-descr b/devel/py-argparse-manpage/pkg-descr
new file mode 100644
index 000000000000..4134dfc1e24c
--- /dev/null
+++ b/devel/py-argparse-manpage/pkg-descr
@@ -0,0 +1,12 @@
+Avoid documenting your Python script arguments on two places! This is typically
+done in an argparse.ArgumentParser help configuration (help=, description=,
+etc.), and also in a manually crafted manual page.
+
+The good thing about an ArgumentParser objects is that it actually provides a
+traversable "tree-like" structure, with all the necessary info needed to
+automatically generate documentation, for example in a groff typesetting system
+(manual pages). And this is where this project can help.
+
+There are two supported ways to generate the manual, either script it using the
+installed command argparse-manpage, or via setup.py build automation (with a
+slight bonus of automatic manual page installation with setup.py install).