From nobody Mon Nov 27 18:08:20 2023 X-Original-To: dev-commits-ports-all@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 4SfD9122HSz52MZb; Mon, 27 Nov 2023 18:08:21 +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 "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4SfD906f3Pz4NqM; Mon, 27 Nov 2023 18:08:20 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1701108500; 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=7GbRB3cmVS+jWr1QOrr7jaTeOAz2pIQmw3SmnZ+9xv0=; b=gk8/hSQdW5yl5L4OiP66Udb0oP5cYMSB01echwNzcfbQvzcCRUHacOyinNxE9ULqzBO5S4 HZiDaVdmTvIf7AF/2K7V6o+uD3V92reCk+kk+ueLN2pVqRAWLtezGdSSI19Kli+uSgxpiu o8I33PhBhZJKY8yqQYRPQiAPGJfr+PSGyTk+fzNiOQjXikF6EVhWRTx9RcnIGsG6rCIS5X QR6xAGOLF8bETl/lCg6ZTTD28+QUbB8yrrmfkD1NBdfvUoEAW1X2R5l9nQcW88G9Hxyp6/ d1wLMM017Iwsld/X9IEwkj+6ou40uj2rH8B0/Sg6RU5NhK4ZVb042MzZWjcW2A== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1701108500; 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=7GbRB3cmVS+jWr1QOrr7jaTeOAz2pIQmw3SmnZ+9xv0=; b=rbvRV1744jQqPfU+7EjW8mM1cUlnmcVj13rZeSDCcmZVUEODmwMvV73BqhUmh1H8LXUt83 ZS5Wtha/th0Mt4rt+xr6a9heCX/dx4L7jBc990K0wx4K4vVYoyGEyDGh16Nu8pItYGnjmL Dzo7R++bAo2W2dt56hzjjyQ2GDwffV6zB8bv3bLnH8AD5GZTq6BlhFxkTCLCwmxncK65MG xy3slR9N7JARiZiQ1CLnqvfVHcdJ3NUNNefvayWWrOC4pJ4bf9CsWsOzaEj5JlyirLGGC3 xG8WB/z//cG/1sjqFuBPxaZuD8FVGvq0EhqaYglcD8P1vswGsLUhHz6w92qpFQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1701108500; a=rsa-sha256; cv=none; b=XVFhtY/WQqd6li24rie+mXH0ohpcxq19brvzlR2ybP2M84toMMqn4bR2b10nL1AazTB8tS PBvsgCGndWCChsFdI4zkptyV/R99RBlTejlPRBBVDPaeXNk4DVDrqjZNJkvS4uISFAhGLc vaMa6J48uL92hlT12AmphgyNY0iysu/6eIAYhqdpsnxeyfNn5FsZu2VGEIdNyEsub1151m +LIh78HIZ6yQz8bPDPmRVLfn6gx7mwc6u1TUdr3JwOK+AxX6SRbV0CjmXqoafC6SO/QmhP USOiM+hnwm2hfNG8MySMkKXiyegJl4c6mPUF1SBatiGS4ycmcAgA2JAVBc+JZQ== 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 4SfD905jTGzpHC; Mon, 27 Nov 2023 18:08:20 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.17.1/8.17.1) with ESMTP id 3ARI8KaM066552; Mon, 27 Nov 2023 18:08:20 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.17.1/8.17.1/Submit) id 3ARI8K2F066549; Mon, 27 Nov 2023 18:08:20 GMT (envelope-from git) Date: Mon, 27 Nov 2023 18:08:20 GMT Message-Id: <202311271808.3ARI8K2F066549@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: c18d4609ce05 - main - devel/py-docformatter: Add py-docformatter 1.7.5 List-Id: Commit messages for all branches of the ports repository List-Archive: https://lists.freebsd.org/archives/dev-commits-ports-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-ports-all@freebsd.org X-BeenThere: dev-commits-ports-all@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: c18d4609ce0539c00b85a7e139ac9da1f4237b92 Auto-Submitted: auto-generated The branch main has been updated by sunpoet: URL: https://cgit.FreeBSD.org/ports/commit/?id=c18d4609ce0539c00b85a7e139ac9da1f4237b92 commit c18d4609ce0539c00b85a7e139ac9da1f4237b92 Author: Po-Chuan Hsieh AuthorDate: 2023-11-27 17:39:49 +0000 Commit: Po-Chuan Hsieh CommitDate: 2023-11-27 18:07:44 +0000 devel/py-docformatter: Add py-docformatter 1.7.5 docformatter automatically formats docstrings to follow a subset of the PEP 257 conventions. Below are the relevant items quoted from PEP 257. - For consistency, always use triple double quotes around docstrings. - Triple quotes are used even though the string fits on one line. - Multi-line docstrings consist of a summary line just like a one-line docstring, followed by a blank line, followed by a more elaborate description. - Unless the entire docstring fits on a line, place the closing quotes on a line by themselves. docformatter also handles some of the PEP 8 conventions. - Don't write string literals that rely on significant trailing whitespace. Such trailing whitespace is visually indistinguishable and some editors (or more recently, reindent.py) will trim them. docformatter formats docstrings compatible with black when passed the --black option. docformatter formats field lists that use Epytext or Sphinx styles. --- devel/Makefile | 1 + devel/py-docformatter/Makefile | 36 ++++++++++++++++++++++++++++++++++++ devel/py-docformatter/distinfo | 3 +++ devel/py-docformatter/pkg-descr | 18 ++++++++++++++++++ 4 files changed, 58 insertions(+) diff --git a/devel/Makefile b/devel/Makefile index a97496f92cab..cfe4cab123c3 100644 --- a/devel/Makefile +++ b/devel/Makefile @@ -4574,6 +4574,7 @@ SUBDIR += py-dj42-django-rq SUBDIR += py-dj42-graphene-django SUBDIR += py-django-rq + SUBDIR += py-docformatter SUBDIR += py-dockerpty SUBDIR += py-docopt SUBDIR += py-doctest-ignore-unicode diff --git a/devel/py-docformatter/Makefile b/devel/py-docformatter/Makefile new file mode 100644 index 000000000000..4f11b9e5460b --- /dev/null +++ b/devel/py-docformatter/Makefile @@ -0,0 +1,36 @@ +PORTNAME= docformatter +PORTVERSION= 1.7.5 +CATEGORIES= devel python +MASTER_SITES= PYPI +PKGNAMEPREFIX= ${PYTHON_PKGNAMEPREFIX} + +MAINTAINER= sunpoet@FreeBSD.org +COMMENT= Format docstrings to follow PEP 257 +WWW= https://docformatter.readthedocs.io/en/latest/ \ + https://github.com/PyCQA/docformatter + +LICENSE= MIT +LICENSE_FILE= ${WRKSRC}/LICENSE + +BUILD_DEPENDS= ${PYTHON_PKGNAMEPREFIX}poetry-core>=1.0.0:devel/py-poetry-core@${PY_FLAVOR} +RUN_DEPENDS= ${PYTHON_PKGNAMEPREFIX}charset-normalizer>=3.0.0<4:textproc/py-charset-normalizer@${PY_FLAVOR} \ + ${PYTHON_PKGNAMEPREFIX}untokenize>=0.1.1<0.2:devel/py-untokenize@${PY_FLAVOR} + +USES= python shebangfix +USE_PYTHON= autoplist concurrent pep517 + +NO_ARCH= yes + +SHEBANG_FILES= src/docformatter/__main__.py + +OPTIONS_DEFINE= TOMLI +OPTIONS_DEFAULT=TOMLI +TOMLI_DESC= TOML (Tom's Obvious Minimal Language) support + +.include + +.if ${PORT_OPTIONS:MTOMLI} && ${PYTHON_REL} < 31100 +RUN_DEPENDS+= ${PYTHON_PKGNAMEPREFIX}tomli>=2.0.0<3:textproc/py-tomli@${PY_FLAVOR} +.endif + +.include diff --git a/devel/py-docformatter/distinfo b/devel/py-docformatter/distinfo new file mode 100644 index 000000000000..eca1c0c85b69 --- /dev/null +++ b/devel/py-docformatter/distinfo @@ -0,0 +1,3 @@ +TIMESTAMP = 1701083330 +SHA256 (docformatter-1.7.5.tar.gz) = ffed3da0daffa2e77f80ccba4f0e50bfa2755e1c10e130102571c890a61b246e +SIZE (docformatter-1.7.5.tar.gz) = 25893 diff --git a/devel/py-docformatter/pkg-descr b/devel/py-docformatter/pkg-descr new file mode 100644 index 000000000000..e852b01270d0 --- /dev/null +++ b/devel/py-docformatter/pkg-descr @@ -0,0 +1,18 @@ +docformatter automatically formats docstrings to follow a subset of the PEP 257 +conventions. Below are the relevant items quoted from PEP 257. +- For consistency, always use triple double quotes around docstrings. +- Triple quotes are used even though the string fits on one line. +- Multi-line docstrings consist of a summary line just like a one-line + docstring, followed by a blank line, followed by a more elaborate description. +- Unless the entire docstring fits on a line, place the closing quotes on a line + by themselves. + +docformatter also handles some of the PEP 8 conventions. +- Don't write string literals that rely on significant trailing whitespace. Such + trailing whitespace is visually indistinguishable and some editors (or more + recently, reindent.py) will trim them. + +docformatter formats docstrings compatible with black when passed the --black +option. + +docformatter formats field lists that use Epytext or Sphinx styles.