From nobody Thu Sep 05 06:19:32 2024 X-Original-To: dev-commits-ports-main@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4Wzq2X4GrFz5VH2v; Thu, 05 Sep 2024 06:19:32 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R11" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Wzq2X1yJNz40gR; Thu, 5 Sep 2024 06:19:32 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1725517172; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=lxm0TUIKybkLMzcszFA7npegV3BE5H/oDevMT98Wtz0=; b=QTxuezMehW90OxJ3FhAj2K05/WD5HqEi6KjCX12R7j5Cq6kmldvNEramerFATwPHIA9Sjx HAHqF0MuLELfiBdSolFSVt6xmkEdM7o7hSDwjGT+qNndAJU1iHZKcNQYowofqGaXe2eMzb pny0+A3pRGfXDBqJRW8s9EztOuUVyYMDWubky/YifoAsW07AgpIkv5rh2gVzK38uj4nuA8 UtD4zV7TRJAwb8WPfW0bwMe6fOYST05LIxbrkn069A6eCHj12xaUNgn4W2i0YIqBGsekEf 1V2SdaDVjeHcDPcLPYKAZCT1S5cAbGQFsv5SF2pCMoWCIHbTFlkL0OpmmH0lCg== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1725517172; a=rsa-sha256; cv=none; b=KQaTzDPQeHVW42glAe1Y8dTnQ2oyIyGRZc4QNI0b4IUYVN/wMAxlo9CUwwgtbMnlKC/h1C 9QadUMoaNIecgE0qnQlEXTmzdw1i8/IMmT/yeU6+O5K2jmkm3dwow3hCrVXbF3zvDqQ1B4 HFQzJb/OeFTeLdEE5B1Cri+72G2Unb/pP36vmkDuX90Oqvsoyo4a1FIZRUXwJp4WmEdqa1 wjg07INplcpg7aJ+/b7yrZCBYsrKqb9s+1E53a8oGOaFLVvxEltPVpEbwsAR5PUrUom+Hk AvZNadHKn7y5lF1hr0bLKPLU+4b9Amf1rGAMxcZW7XOsUxvnSOjMI5fq9jvwKQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1725517172; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=lxm0TUIKybkLMzcszFA7npegV3BE5H/oDevMT98Wtz0=; b=bW3B1b42sGAWzT2qFWQ8XbCx2HMkWT7p///9POfCsCSTHCXbqvTnaUzQaTSC5MYNmPFmwE zTWFAixFME6g8yE7oe3zBrsLuAGPSpl4wXL0De11wDrDruk5JtDz82asM22YeNGXVb4jnn RbdrnegY/XUW0DS14XaysAT5kWf/zInsjjwqozSV9X7fgpKBZyMMUSaEbZGeSWkw1DEbHV k0KPyhP7gVAGSnlfVRCiy22PXmOal1u5JGM/yHZd7hi8IvtJ1BROmtKyypZNhlQl/u3qvx 4q99SL/Wsf4eu0anyyX5gfW0HGJPS4CggEFnLHDg2TlgjXcPPiQ5/y/TrSJM7A== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4Wzq2X0vM4zwbQ; Thu, 5 Sep 2024 06:19:32 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 4856JWNa091664; Thu, 5 Sep 2024 06:19:32 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 4856JWeG091661; Thu, 5 Sep 2024 06:19:32 GMT (envelope-from git) Date: Thu, 5 Sep 2024 06:19:32 GMT Message-Id: <202409050619.4856JWeG091661@gitrepo.freebsd.org> To: ports-committers@FreeBSD.org, dev-commits-ports-all@FreeBSD.org, dev-commits-ports-main@FreeBSD.org From: Po-Chuan Hsieh Subject: git: eba20a57733d - main - devel/py-argparse-manpage: Add py-argparse-manpage 4.6 List-Id: Commits to the main branch of the FreeBSD ports repository List-Archive: https://lists.freebsd.org/archives/dev-commits-ports-main List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-ports-main@freebsd.org Sender: owner-dev-commits-ports-main@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: sunpoet X-Git-Repository: ports X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: eba20a57733da6482627fe49cf86a131fb58b546 Auto-Submitted: auto-generated The branch main has been updated by sunpoet: URL: https://cgit.FreeBSD.org/ports/commit/?id=eba20a57733da6482627fe49cf86a131fb58b546 commit eba20a57733da6482627fe49cf86a131fb58b546 Author: Po-Chuan Hsieh AuthorDate: 2024-09-05 05:14:04 +0000 Commit: Po-Chuan Hsieh 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 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).