Skip site navigation (1)Skip section navigation (2)
Date:      Mon, 6 Oct 2025 08:29:46 GMT
From:      Yuri Victorovich <yuri@FreeBSD.org>
To:        ports-committers@FreeBSD.org, dev-commits-ports-all@FreeBSD.org, dev-commits-ports-main@FreeBSD.org
Subject:   git: d5abdc761ed0 - main - www/py-essentials-openapi: New port: Classes to generate OpenAPI Documentation v3 and v2
Message-ID:  <202510060829.5968TkV4042834@gitrepo.freebsd.org>

index | next in thread | raw e-mail

The branch main has been updated by yuri:

URL: https://cgit.FreeBSD.org/ports/commit/?id=d5abdc761ed083d6acbeee09400675993062d609

commit d5abdc761ed083d6acbeee09400675993062d609
Author:     Yuri Victorovich <yuri@FreeBSD.org>
AuthorDate: 2025-10-06 07:49:07 +0000
Commit:     Yuri Victorovich <yuri@FreeBSD.org>
CommitDate: 2025-10-06 08:25:53 +0000

    www/py-essentials-openapi: New port: Classes to generate OpenAPI Documentation v3 and v2
---
 www/Makefile                        |  1 +
 www/py-essentials-openapi/Makefile  | 30 ++++++++++++++++++++++++++++++
 www/py-essentials-openapi/distinfo  |  3 +++
 www/py-essentials-openapi/pkg-descr | 15 +++++++++++++++
 4 files changed, 49 insertions(+)

diff --git a/www/Makefile b/www/Makefile
index 87258e5e01ac..d2a30ac7c3e6 100644
--- a/www/Makefile
+++ b/www/Makefile
@@ -1727,6 +1727,7 @@
     SUBDIR += py-dropbox
     SUBDIR += py-dtflickr
     SUBDIR += py-enmerkar
+    SUBDIR += py-essentials-openapi
     SUBDIR += py-fake-useragent
     SUBDIR += py-falcon
     SUBDIR += py-fastapi
diff --git a/www/py-essentials-openapi/Makefile b/www/py-essentials-openapi/Makefile
new file mode 100644
index 000000000000..84f8be208d3c
--- /dev/null
+++ b/www/py-essentials-openapi/Makefile
@@ -0,0 +1,30 @@
+PORTNAME=	essentials-openapi
+DISTVERSIONPREFIX=	v
+DISTVERSION=	1.2.1
+CATEGORIES=	www python
+#MASTER_SITES=	PYPI # no tests
+PKGNAMEPREFIX=	${PYTHON_PKGNAMEPREFIX}
+
+MAINTAINER=	yuri@FreeBSD.org
+COMMENT=	Classes to generate OpenAPI Documentation v3 and v2
+WWW=		https://github.com/Neoteroi/essentials-openapi
+
+LICENSE=	MIT
+LICENSE_FILE=	${WRKSRC}/LICENSE
+
+BUILD_DEPENDS=	${PYTHON_PKGNAMEPREFIX}hatchling>0:devel/py-hatchling@${PY_FLAVOR}
+RUN_DEPENDS=	${PYTHON_PKGNAMEPREFIX}essentials>=1.1.5:devel/py-essentials@${PY_FLAVOR} \
+		${PYTHON_PKGNAMEPREFIX}markupsafe>=3.0.0:textproc/py-markupsafe@${PY_FLAVOR} \
+		${PYTHON_PKGNAMEPREFIX}pyyaml>=6:devel/py-pyyaml@${PY_FLAVOR}
+TEST_DEPENDS=	${PYTHON_PKGNAMEPREFIX}pytest-asyncio>0:devel/py-pytest-asyncio@${PY_FLAVOR}
+
+USES=		python
+USE_PYTHON=	pep517 autoplist pytest
+USE_GITHUB=	yes
+GH_ACCOUNT=	Neoteroi
+
+TEST_ENV=	${MAKE_ENV} PYTHONPATH=${STAGEDIR}${PYTHONPREFIX_SITELIBDIR}
+
+# tests as of 1.2.1: 157 passed in 8.00s
+
+.include <bsd.port.mk>
diff --git a/www/py-essentials-openapi/distinfo b/www/py-essentials-openapi/distinfo
new file mode 100644
index 000000000000..97de9b762b47
--- /dev/null
+++ b/www/py-essentials-openapi/distinfo
@@ -0,0 +1,3 @@
+TIMESTAMP = 1759700656
+SHA256 (Neoteroi-essentials-openapi-v1.2.1_GH0.tar.gz) = 88d587003a52a154bb7d512f24a7bb2af25776e6bad7767d1a8868c672595db0
+SIZE (Neoteroi-essentials-openapi-v1.2.1_GH0.tar.gz) = 86098
diff --git a/www/py-essentials-openapi/pkg-descr b/www/py-essentials-openapi/pkg-descr
new file mode 100644
index 000000000000..be99c659b850
--- /dev/null
+++ b/www/py-essentials-openapi/pkg-descr
@@ -0,0 +1,15 @@
+Essentials OpenAPI provides classes and utilities to generate OpenAPI
+Documentation in both version 3 and version 2 formats. It supports
+output in JSON and YAML formats for API documentation.
+
+Key features:
+* Generate OpenAPI 3.x and 2.x documentation
+* Support for JSON and YAML output formats
+* Automatic schema generation from Python types
+* Integration with web frameworks
+* Extensible documentation system
+* Template-based documentation generation
+* Command-line interface for documentation generation
+
+This library is particularly useful for web APIs that need to generate
+comprehensive API documentation automatically from code annotations.


home | help

Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?202510060829.5968TkV4042834>