jdkman 0.1.2__tar.gz

jdkman-0.1.2/PKG-INFO

@@ -0,0 +1,208 @@
+Metadata-Version: 2.3
+Name: jdkman
+Version: 0.1.2
+Summary: A command-line tool for installing and managing OpenJDK distributions.
+Author: junghun.song
+Author-email: junghun.song <xunyss@gmail.com>
+Requires-Dist: requests>=2.32.5
+Requires-Dist: typer-slim>=0.24.0
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+
+# jdkman
+
+A command-line tool for installing and managing OpenJDK distributions.
+
+---
+
+## Why jdkman?
+
+How often do you actually need to pick between `21.0.3` and `21.0.5`?
+Probably never. "The latest Zulu 21" is almost always good enough.
+
+jdkman manages JDKs at exactly that level — no more, no less.
+
+- `jdk install zulu-21` — just pick a vendor and a major version
+- `jdk upgrade zulu-21` — updates to the latest patch automatically
+- One installation per vendor + major version, always
+
+No scrolling through minor version lists. No patch versions piling up.
+
+On macOS, JDKs are installed under `~/Library/Java/JavaVirtualMachines/` — the standard
+path where Gradle, IntelliJ, and most other tools automatically look for JDKs.
+No extra configuration needed.
+
+---
+
+## Requirements
+
+- Python 3.12+
+
+## Installation
+
+```bash
+pip install jdkman
+```
+
+## Quick Start
+
+```bash
+# Browse available JDK distributions
+jdk remote
+
+# Install a distribution
+jdk install zulu-21
+
+# List installed distributions
+jdk list
+
+# Check for outdated installations
+jdk outdated
+```
+
+---
+
+## Commands
+
+### `jdk remote [DISTRO]`
+
+Browse JDK distributions available for download.
+
+By default, shows only stable JDK builds. Use flags to include additional build types.
+
+```bash
+jdk remote                    # List all stable JDK builds
+jdk remote zulu               # Filter by vendor prefix
+jdk remote --version 21       # Filter by major version
+jdk remote --all              # Include JRE and feature builds
+jdk remote --with-jre         # Include JRE builds
+jdk remote --with-feat        # Include feature builds (e.g. JavaFX, CRaC)
+jdk remote --all zulu         # Combined: all build types, zulu only
+```
+
+**Options:**
+
+| Option | Short | Description |
+|--------|-------|-------------|
+| `--version` | `-v` | Filter by major version number |
+| `--all` | `-a` | Include all build types |
+| `--with-jre` | `-R` | Include JRE builds |
+| `--with-feat` | `-F` | Include feature builds |
+
+---
+
+### `jdk install <DISTRO>`
+
+Download and install a JDK distribution.
+
+```bash
+jdk install zulu-21
+jdk install temurin-17
+jdk install zulu-jre-21          # JRE variant
+jdk install zulu-javafx-21       # With JavaFX
+jdk install zulu-crac-21         # With CRaC
+jdk install zulu-javafx-jre-21   # JRE + JavaFX
+```
+
+The `DISTRO` name follows this pattern:
+```
+{vendor}[-{feature}][-jre]-{major_version}
+```
+
+Use `jdk remote` to find the exact distribution name.
+
+---
+
+### `jdk list`
+
+Show all installed JDK distributions managed by jdkman.
+
+```bash
+jdk list
+jdk ls      # alias
+```
+
+---
+
+### `jdk uninstall <DISTRO>`
+
+Remove an installed JDK distribution.
+
+```bash
+jdk uninstall zulu-21
+jdk remove zulu-21    # alias
+jdk rm zulu-21        # alias
+```
+
+---
+
+### `jdk upgrade <DISTRO>`
+
+Upgrade an installed distribution to the latest patch version.
+
+```bash
+jdk upgrade zulu-21
+jdk update zulu-21    # alias
+```
+
+---
+
+### `jdk outdated`
+
+List installed distributions that have newer versions available.
+
+```bash
+jdk outdated
+```
+
+---
+
+### `jdk vendors`
+
+List all available JDK vendors.
+
+```bash
+jdk vendors
+jdk vendor    # alias
+```
+
+---
+
+### `jdk cleanup`
+
+Remove cached data (downloaded archives and catalog cache).
+
+```bash
+jdk cleanup
+jdk clean     # alias
+jdk clear     # alias
+```
+
+---
+
+### `jdk home` *(macOS only)*
+
+Show Java home paths for JVMs registered with the system.
+
+```bash
+jdk home           # List registered Java installations
+jdk home --json    # Show detailed info in JSON format
+```
+
+---
+
+### `jdk version`
+
+Show the jdkman version.
+
+```bash
+jdk version
+jdk --version
+jdk -v
+```
+
+---
+
+## License
+
+MIT

jdkman-0.1.2/README.md

@@ -0,0 +1,197 @@
+# jdkman
+
+A command-line tool for installing and managing OpenJDK distributions.
+
+---
+
+## Why jdkman?
+
+How often do you actually need to pick between `21.0.3` and `21.0.5`?
+Probably never. "The latest Zulu 21" is almost always good enough.
+
+jdkman manages JDKs at exactly that level — no more, no less.
+
+- `jdk install zulu-21` — just pick a vendor and a major version
+- `jdk upgrade zulu-21` — updates to the latest patch automatically
+- One installation per vendor + major version, always
+
+No scrolling through minor version lists. No patch versions piling up.
+
+On macOS, JDKs are installed under `~/Library/Java/JavaVirtualMachines/` — the standard
+path where Gradle, IntelliJ, and most other tools automatically look for JDKs.
+No extra configuration needed.
+
+---
+
+## Requirements
+
+- Python 3.12+
+
+## Installation
+
+```bash
+pip install jdkman
+```
+
+## Quick Start
+
+```bash
+# Browse available JDK distributions
+jdk remote
+
+# Install a distribution
+jdk install zulu-21
+
+# List installed distributions
+jdk list
+
+# Check for outdated installations
+jdk outdated
+```
+
+---
+
+## Commands
+
+### `jdk remote [DISTRO]`
+
+Browse JDK distributions available for download.
+
+By default, shows only stable JDK builds. Use flags to include additional build types.
+
+```bash
+jdk remote                    # List all stable JDK builds
+jdk remote zulu               # Filter by vendor prefix
+jdk remote --version 21       # Filter by major version
+jdk remote --all              # Include JRE and feature builds
+jdk remote --with-jre         # Include JRE builds
+jdk remote --with-feat        # Include feature builds (e.g. JavaFX, CRaC)
+jdk remote --all zulu         # Combined: all build types, zulu only
+```
+
+**Options:**
+
+| Option | Short | Description |
+|--------|-------|-------------|
+| `--version` | `-v` | Filter by major version number |
+| `--all` | `-a` | Include all build types |
+| `--with-jre` | `-R` | Include JRE builds |
+| `--with-feat` | `-F` | Include feature builds |
+
+---
+
+### `jdk install <DISTRO>`
+
+Download and install a JDK distribution.
+
+```bash
+jdk install zulu-21
+jdk install temurin-17
+jdk install zulu-jre-21          # JRE variant
+jdk install zulu-javafx-21       # With JavaFX
+jdk install zulu-crac-21         # With CRaC
+jdk install zulu-javafx-jre-21   # JRE + JavaFX
+```
+
+The `DISTRO` name follows this pattern:
+```
+{vendor}[-{feature}][-jre]-{major_version}
+```
+
+Use `jdk remote` to find the exact distribution name.
+
+---
+
+### `jdk list`
+
+Show all installed JDK distributions managed by jdkman.
+
+```bash
+jdk list
+jdk ls      # alias
+```
+
+---
+
+### `jdk uninstall <DISTRO>`
+
+Remove an installed JDK distribution.
+
+```bash
+jdk uninstall zulu-21
+jdk remove zulu-21    # alias
+jdk rm zulu-21        # alias
+```
+
+---
+
+### `jdk upgrade <DISTRO>`
+
+Upgrade an installed distribution to the latest patch version.
+
+```bash
+jdk upgrade zulu-21
+jdk update zulu-21    # alias
+```
+
+---
+
+### `jdk outdated`
+
+List installed distributions that have newer versions available.
+
+```bash
+jdk outdated
+```
+
+---
+
+### `jdk vendors`
+
+List all available JDK vendors.
+
+```bash
+jdk vendors
+jdk vendor    # alias
+```
+
+---
+
+### `jdk cleanup`
+
+Remove cached data (downloaded archives and catalog cache).
+
+```bash
+jdk cleanup
+jdk clean     # alias
+jdk clear     # alias
+```
+
+---
+
+### `jdk home` *(macOS only)*
+
+Show Java home paths for JVMs registered with the system.
+
+```bash
+jdk home           # List registered Java installations
+jdk home --json    # Show detailed info in JSON format
+```
+
+---
+
+### `jdk version`
+
+Show the jdkman version.
+
+```bash
+jdk version
+jdk --version
+jdk -v
+```
+
+---
+
+## License
+
+MIT

jdkman-0.1.2/pyproject.toml

@@ -0,0 +1,31 @@
+[project]
+name = "jdkman"
+version = "0.1.2"
+description = "A command-line tool for installing and managing OpenJDK distributions."
+authors = [{name = "junghun.song", email = "xunyss@gmail.com"}]
+readme = "README.md"
+requires-python = ">=3.12"
+dependencies = [
+    "requests>=2.32.5",
+    "typer-slim>=0.24.0",
+]
+
+[project.scripts]
+jdk = "jdkman.cli:app"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]
+
+[build-system]
+requires = ["uv_build >= 0.8.14, <0.11.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "pytest>=9.0.2",
+]
+

jdkman-0.1.2/src/jdkman/catalog.py

@@ -0,0 +1,203 @@
+import json
+import time
+
+import requests
+
+from .config import CATALOG_CACHE_FILE, CATALOG_CACHE_TTL, JVM_API_URL
+from .console import out
+from .utils import version_key
+
+
+def fetch_artifacts() -> list[dict]:
+    """
+    {
+        "checksum": "sha256:0000000000000000000000000000000000000000000000000000000000000000",
+        "created_at": "2025-03-28T22:02:46.826962",
+        "features": [],
+        "file_type": "zip",
+        "image_type": "jre",
+        "java_version": "17.0.2",
+        "jvm_impl": "hotspot",
+        "url": "https://cdn.azul.com/zulu/bin/zulu17.32.13-ca-jre17.0.2-macosx_aarch64.zip",
+        "vendor": "zulu",
+        "version": "17.32.13.0"
+    }
+    """
+    if CATALOG_CACHE_FILE.exists() and (time.time() - CATALOG_CACHE_FILE.stat().st_mtime) < CATALOG_CACHE_TTL:
+        artifacts = json.loads(CATALOG_CACHE_FILE.read_text())
+    else:
+        out("==> Fetching JVM Database...")
+        response = requests.get(JVM_API_URL, timeout=30)
+        response.raise_for_status()
+        artifacts: list[dict] = response.json()
+
+        CATALOG_CACHE_FILE.parent.mkdir(parents=True, exist_ok=True)
+        CATALOG_CACHE_FILE.write_text(json.dumps(artifacts))
+
+    return artifacts
+
+
+def fetch_releases():
+    """
+    {
+        "vendor": "zulu",
+        "image_type": "jre",
+        "features": [],
+        "jvm_impl": "hotspot",
+        "java_version": "17.0.2",
+        "version": "17.32.13.0",
+        "dists": [
+            {
+                "file_type": "zip",
+                "url": "https://cdn.azul.com/zulu/bin/zulu17.32.13-ca-jre17.0.2-macosx_aarch64.zip",
+                "checksum": "sha256:0000000000000000000000000000000000000000000000000000000000000000",
+                "created_at": "2025-03-28T22:02:46.826962"
+            },
+            ...
+        ]
+    }
+    """
+    _group_keys = ("vendor", "image_type", "features", "jvm_impl", "java_version", "version")
+    _dist_keys = ("file_type", "url", "checksum", "created_at")
+    releases: dict[tuple, dict] = {}
+    for artifact in fetch_artifacts():
+        key = (artifact["vendor"], artifact["image_type"], tuple(sorted(artifact["features"])), artifact["jvm_impl"], artifact["java_version"], artifact["version"])
+        if key not in releases:
+            releases[key] = {
+                k: artifact[k]
+                for k in _group_keys
+            } | {
+              "dists": []
+            }
+
+        releases[key]["dists"].append({
+            k: artifact[k] for k in _dist_keys
+        })
+
+    return list(releases.values())
+
+
+def make_slug(release_info: dict) -> str:
+    """
+    features cases: [
+        "[]",
+        ["javafx"]",                             # zulu
+        ["crac"],                                # zulu
+        ["jcef"]",                               # jetbrains
+        ["lite"],                                # liberica
+        ["javafx", "libericafx", "minimal-vm"],  # liberica
+        ["notarized"]                            # kona
+    ]
+    jvm_impl cases: [
+        "hotspot",
+        "graalvm",
+        "openj9"    # semeru (semeru 의 모든 dist 는 "openj9" 임)
+    ]
+    """
+    feature = release_info["features"][0] if release_info["features"] and release_info["features"] != ["notarized"] else ""
+    jvm_impl = release_info["jvm_impl"] if release_info["jvm_impl"] not in ["hotspot", "graalvm"] else ""
+
+    parts = [release_info["vendor"]]
+    if release_info["image_type"] == "jre":
+        parts.append(release_info["image_type"])
+    if feature:
+        parts.append(feature)
+    if jvm_impl:
+        parts.append(jvm_impl)
+    parts.append(str(release_info["major_version"]))
+
+    return "-".join(parts)
+
+
+def fetch_slugs():
+    """
+    {
+        "zulu-jre-17": {
+            "vendor": "zulu",
+            "image_type": "jre",
+            "features": [],
+            "jvm_impl": "hotspot",
+            "major_version": 17,
+            "latest": "17.64.17.0",
+            "versions": [
+                {
+                    "java_version": "17.0.2",
+                    "version": "17.64.15.0",
+                    "dists": [
+                        {
+                            "file_type": "tar.gz",
+                            "url": "https://cdn.azul.com/zulu/bin/zulu17.64.15-ca-jre17.0.18-macosx_aarch64.tar.gz",
+                            "checksum": "sha256:0000000000000000000000000000000000000000000000000000000000000000",
+                            "created_at": "2026-01-21T22:04:16.168823"
+                        },
+                        ...
+                    ]
+                },
+                ...
+            ]
+        },
+        ...
+    }
+    """
+    slugs: dict[str, dict] = {}
+    for release in fetch_releases():
+        release_info = {
+            "vendor": release["vendor"],
+            "image_type": release["image_type"],
+            "features": release["features"],
+            "jvm_impl": release["jvm_impl"],
+            "major_version": version_key(release["java_version"])[0][0],
+        }
+        slug = make_slug(release_info)
+        if slug not in slugs:
+            slugs[slug] = release_info | {
+                "latest": release["version"],
+                "versions": [],
+            }
+        else:
+            if version_key(release["version"]) > version_key(slugs[slug]["latest"]):
+                slugs[slug]["latest"] = release["version"]
+
+        slugs[slug]["versions"].append({
+            "java_version": release["java_version"],
+            "version": release["version"],
+            "dists": release["dists"]
+        })
+
+    return slugs
+
+
+def sort_slugs(slugs: dict) -> dict:
+    # 3. dists 정렬: created_at
+    def sort_dists(versions):
+        return [
+            {
+                **version,
+                "dists": sorted(version["dists"], key=lambda x: x["created_at"])
+            }
+            for version in versions
+        ]
+
+    # 2. versions 정렬: version
+    def sort_versions(versions):
+        sorted_versions = sorted(versions, key=lambda x: version_key(x["version"]))
+        return sort_dists(sorted_versions)
+
+    # 1. slug 객체 정렬: vendor, image_type, features[0], major_version
+    def slug_sort_key(slug_item):
+        slug, slug_info = slug_item
+        return (
+            slug_info["vendor"],
+            slug_info["image_type"],
+            slug_info["features"][0] if slug_info["features"] else "",
+            slug_info["major_version"],
+        )
+
+    return {
+        slug: {
+            **slug_info,
+            "versions": sort_versions(slug_info["versions"])
+        }
+        for slug, slug_info in sorted(slugs.items(), key=slug_sort_key)
+    }
+