openapi-generator-cli 7.10.0__tar.gz → 7.10.0.post0__tar.gz

{openapi_generator_cli-7.10.0 → openapi_generator_cli-7.10.0.post0}/PKG-INFO

@@ -1,10 +1,10 @@
 Metadata-Version: 2.1
 Name: openapi-generator-cli
-Version: 7.10.0
+Version: 7.10.0.post0
 Summary: CLI for openapi generator
 Home-page: https://openapi-generator.tech
 License: APACHE 2.0
-Keywords: opeapi,generator,cli
+Keywords: openapi,generator,cli
 Author: OpenAPI Generator community
 Author-email: team@openapitools.org
 Requires-Python: >=3.9,<4
@@ -20,16 +20,22 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Programming Language :: Python :: Implementation :: PyPy
+Provides-Extra: jdk4py
+Requires-Dist: jdk4py (>=21.0.4.1,<22.0.0.0) ; (python_version >= "3.10") and (extra == "jdk4py")
 Project-URL: Documentation, https://github.com/OpenAPITools/openapi-generator#3---usage
 Project-URL: Repository, https://github.com/OpenAPITools/openapi-generator
 Description-Content-Type: text/markdown
 
-# OpenApi Generator PIP Package Generator
+# OpenAPI Generator in Package Installer for Python (PIP)
 
 [![Join the Slack chat room](
   <https://img.shields.io/badge/Slack-Join%20the%20chat%20room-orange>
 )](
   <https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g>
+) [![PyPI version](
+  <https://badge.fury.io/py/openapi-generator-cli.svg>
+)](
+  <https://badge.fury.io/py/openapi-generator-cli>
 ) [![Code style: black](
   <https://img.shields.io/badge/code%20style-black-000000.svg>
 )](
@@ -60,6 +66,12 @@ pip install openapi-generator-cli
 pip install openapi-generator-cli==4.3.1
 ```
 
+You can also install with [`jdk4py`] instead of `java` binary. (`python>=3.10` is required)
+
+```sh
+pip install openapi-generator-cli[jdk4py]
+```
+
 After installation `openapi-generator-cli` command will be available in your virtual environment or globally depending on your installation.
 
 To check the version, for example. Type the following command
@@ -83,5 +95,6 @@ Please raise an issue, happy to hear from you :)
 
 [OpenAPITools/openapi-generator]: <https://github.com/OpenAPITools/openapi-generator>
 [maven repository]: <https://mvnrepository.com/artifact/org.openapitools/openapi-generator-cli>
+[`jdk4py`]: <https://github.com/activeviam/jdk4py>
 [official openapi-generator docs]: <https://github.com/OpenAPITools/openapi-generator#3---usage>
 

{openapi_generator_cli-7.10.0 → openapi_generator_cli-7.10.0.post0}/README.md

@@ -1,9 +1,13 @@
-# OpenApi Generator PIP Package Generator
+# OpenAPI Generator in Package Installer for Python (PIP)
 
 [![Join the Slack chat room](
   <https://img.shields.io/badge/Slack-Join%20the%20chat%20room-orange>
 )](
   <https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g>
+) [![PyPI version](
+  <https://badge.fury.io/py/openapi-generator-cli.svg>
+)](
+  <https://badge.fury.io/py/openapi-generator-cli>
 ) [![Code style: black](
   <https://img.shields.io/badge/code%20style-black-000000.svg>
 )](
@@ -34,6 +38,12 @@ pip install openapi-generator-cli
 pip install openapi-generator-cli==4.3.1
 ```
 
+You can also install with [`jdk4py`] instead of `java` binary. (`python>=3.10` is required)
+
+```sh
+pip install openapi-generator-cli[jdk4py]
+```
+
 After installation `openapi-generator-cli` command will be available in your virtual environment or globally depending on your installation.
 
 To check the version, for example. Type the following command
@@ -57,4 +67,5 @@ Please raise an issue, happy to hear from you :)
 
 [OpenAPITools/openapi-generator]: <https://github.com/OpenAPITools/openapi-generator>
 [maven repository]: <https://mvnrepository.com/artifact/org.openapitools/openapi-generator-cli>
+[`jdk4py`]: <https://github.com/activeviam/jdk4py>
 [official openapi-generator docs]: <https://github.com/OpenAPITools/openapi-generator#3---usage>

openapi_generator_cli-7.10.0.post0/openapi_generator_cli/__init__.py

@@ -0,0 +1,66 @@
+"""A Python wrapper for the OpenAPI Generator CLI."""
+
+from __future__ import annotations
+
+import importlib.resources
+import os
+import shutil
+import subprocess
+import sys
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from pathlib import Path
+
+
+def run(args: list[str] | None = None) -> subprocess.CompletedProcess[bytes]:
+    """Run the OpenAPI Generator CLI with the given arguments.
+
+    Args:
+        args (list[str], optional):
+            The list of arguments to pass to the Open
+            API Generator CLI. If not provided, the CLI will
+            be run without any arguments.
+
+    Returns:
+        subprocess.CompletedProcess[bytes]: The result of running the OpenAPI Generator CLI.
+
+    """
+    java_path: Path | str | None
+    try:
+        from jdk4py import JAVA
+
+        java_path = JAVA
+    except ImportError:
+        java_path = shutil.which("java")
+    if not java_path:
+        msg = "java runtime is not found in PATH"
+        raise RuntimeError(msg)
+
+    arguments = [java_path]
+
+    java_opts = os.getenv("JAVA_OPTS")
+    if java_opts:
+        arguments.append(java_opts)
+
+    arguments.append("-jar")
+
+    jar_path = importlib.resources.files("openapi_generator_cli") / "openapi-generator.jar"
+    arguments.append(str(jar_path))
+
+    if args and isinstance(args, list):
+        arguments.extend(args)
+
+    return subprocess.run(arguments, check=False)  # noqa: S603
+
+
+def cli() -> None:
+    """Run the OpenAPI Generator CLI with the arguments provided on the command line."""
+    args = []
+    if len(sys.argv) > 1:
+        args = sys.argv[1:]
+    run(args)
+
+
+if __name__ == "__main__":
+    cli()

{openapi_generator_cli-7.10.0 → openapi_generator_cli-7.10.0.post0}/pyproject.toml

@@ -7,7 +7,7 @@ requires = [
 ]
 
 [tool.poetry]
-version = "7.10.0"
+version = "7.10.0.post0"
 authors = [
   "OpenAPI Generator community <team@openapitools.org>",
 ]
@@ -21,7 +21,7 @@ classifiers = [
 ]
 description = "CLI for openapi generator"
 keywords = [
-  "opeapi",
+  "openapi",
   "generator",
   "cli",
 ]
@@ -38,12 +38,17 @@ documentation = "https://github.com/OpenAPITools/openapi-generator#3---usage"
 
 [tool.poetry.dependencies]
 python = ">=3.9,<4"
+jdk4py = { version = "^21.0.4.1", optional = true, python = ">=3.10" }
 
 [tool.poetry.group.dev.dependencies]
 mypy = ">=0.991,<1.14"
-pre-commit = ">=2.20,<4.0"
+pre-commit = ">=2.20,<5.0"
 taskipy = "^1.10.3"
 pytest = ">=7.2.2,<9.0.0"
+natsort = "^8.4.0"
+
+[tool.poetry.extras]
+jdk4py = [ "jdk4py" ]
 
 [tool.poetry.scripts]
 openapi-generator-cli = "openapi_generator_cli:cli"
@@ -61,11 +66,18 @@ lint.select = [
   "ALL",
 ]
 lint.ignore = [
-  "D",
+  "D211", # No blank lines allowed before class docstring
+  "D213", # Multi-line docstring summary should start at the second line
 ]
 lint.per-file-ignores."publish.py" = [
+  "D",
+  "S603", # `subprocess` call: check for execution of untrusted input
   "T201", # `print` found
 ]
+lint.per-file-ignores."tests/*" = [
+  "D",
+  "S101", # Use of `assert` detected
+]
 
 [tool.mypy]
 pretty = true
@@ -74,6 +86,9 @@ show_error_codes = true
 strict = true
 
 [tool.taskipy.tasks]
+download-latest-jar = "DOWNLOAD_LATEST_ONLY=1 task publish"
 test = "pytest"
+test-unpublished-versions = "DRYRUN=1 task publish"
 lint = "pre-commit run -a"
+publish = "python publish.py"
 profile = "python -m cProfile"

openapi_generator_cli-7.10.0/openapi_generator_cli/__init__.py

@@ -1,35 +0,0 @@
-from __future__ import annotations
-
-import importlib.resources
-import os
-import subprocess
-import sys
-
-
-def run(args: list[str] | None = None) -> None:
-    arguments = ["java"]
-
-    java_opts = os.getenv("JAVA_OPTS")
-    if java_opts:
-        arguments.append(java_opts)
-
-    arguments.append("-jar")
-
-    jar_path = importlib.resources.files("openapi_generator_cli") / "openapi-generator.jar"
-    arguments.append(str(jar_path))
-
-    if args and type(args) == list:
-        arguments.extend(args)
-
-    subprocess.call(arguments)  # noqa: S603
-
-
-def cli() -> None:
-    args = []
-    if len(sys.argv) > 1:
-        args = sys.argv[1:]
-    run(args)
-
-
-if __name__ == "__main__":
-    cli()