jv-env-cli


Namejv-env-cli JSON
Version 1.0.0 PyPI version JSON
download
home_pagehttps://github.com/sachin-acharya-projects/jv-cli
SummaryJV-CLI is a lightweight command-line tool for managing Java environments. Easily switch between Java versions, set JAVA_HOME, persist changes, and configure multiple installations effortlessly.
upload_time2025-02-09 11:18:50
maintainerNone
docs_urlNone
authorSachin Acharya
requires_python>=3.6
licenseNone
keywords
VCS
bugtrack_url
requirements wheel
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # JV-CLI

## Overview

`jv-cli` is a simple command-line utility for managing Java environment versions. It allows users to set `JAVA_HOME`, make it persistent, configure multiple Java installations, and execute Java commands using a default version.

## Installation

You can install `jv-cli` using pip:

```sh
pip install jv-cli
```

## Usage

Run the following command to see available options:

```sh
jv -h
```

### Commands

-   **Set JAVA_HOME to a specific version:**

    ```sh
    jv -jv <version>
    ```

-   **Persist JAVA_HOME change (Windows only):**

    ```sh
    jv -jv <version> -P
    ```

-   **Set a default Java version:**

    ```sh
    jv -d <version>
    ```

-   **Run Java using the default version:**

    ```sh
    jv -java
    ```

-   **Add a Java version to the config:**

    ```sh
    jv --config <version> <path>
    ```

## Configuration

`jv-cli` maintains its configuration in a JSON file located at:

-   Windows: `%USERPROFILE%/.jv-config/config.json`

The configuration file stores Java versions and their corresponding paths.

## Example Usage

1. Add Java versions to the configuration:

    ```sh
    jv --config 11 "C:\Program Files\Java\jdk-11"
    jv --config 17 "C:\Program Files\Java\jdk-17"
    ```

2. Set Java 11 as the default:

    ```sh
    jv -d 11
    ```

3. Switch to Java 17 temporarily:

    ```sh
    jv -jv 17
    ```

4. Run the default Java version:

    ```sh
    jv -java
    ```

## License

MIT License

Copyright (c) [Year] [Your Name]

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/sachin-acharya-projects/jv-cli",
    "name": "jv-env-cli",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.6",
    "maintainer_email": null,
    "keywords": null,
    "author": "Sachin Acharya",
    "author_email": "example@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/c7/f9/03b61087c0664de72dc490ef37d1113e064378474252454ca2edc2b13a81/jv-env-cli-1.0.0.tar.gz",
    "platform": null,
    "description": "# JV-CLI\r\n\r\n## Overview\r\n\r\n`jv-cli` is a simple command-line utility for managing Java environment versions. It allows users to set `JAVA_HOME`, make it persistent, configure multiple Java installations, and execute Java commands using a default version.\r\n\r\n## Installation\r\n\r\nYou can install `jv-cli` using pip:\r\n\r\n```sh\r\npip install jv-cli\r\n```\r\n\r\n## Usage\r\n\r\nRun the following command to see available options:\r\n\r\n```sh\r\njv -h\r\n```\r\n\r\n### Commands\r\n\r\n-   **Set JAVA_HOME to a specific version:**\r\n\r\n    ```sh\r\n    jv -jv <version>\r\n    ```\r\n\r\n-   **Persist JAVA_HOME change (Windows only):**\r\n\r\n    ```sh\r\n    jv -jv <version> -P\r\n    ```\r\n\r\n-   **Set a default Java version:**\r\n\r\n    ```sh\r\n    jv -d <version>\r\n    ```\r\n\r\n-   **Run Java using the default version:**\r\n\r\n    ```sh\r\n    jv -java\r\n    ```\r\n\r\n-   **Add a Java version to the config:**\r\n\r\n    ```sh\r\n    jv --config <version> <path>\r\n    ```\r\n\r\n## Configuration\r\n\r\n`jv-cli` maintains its configuration in a JSON file located at:\r\n\r\n-   Windows: `%USERPROFILE%/.jv-config/config.json`\r\n\r\nThe configuration file stores Java versions and their corresponding paths.\r\n\r\n## Example Usage\r\n\r\n1. Add Java versions to the configuration:\r\n\r\n    ```sh\r\n    jv --config 11 \"C:\\Program Files\\Java\\jdk-11\"\r\n    jv --config 17 \"C:\\Program Files\\Java\\jdk-17\"\r\n    ```\r\n\r\n2. Set Java 11 as the default:\r\n\r\n    ```sh\r\n    jv -d 11\r\n    ```\r\n\r\n3. Switch to Java 17 temporarily:\r\n\r\n    ```sh\r\n    jv -jv 17\r\n    ```\r\n\r\n4. Run the default Java version:\r\n\r\n    ```sh\r\n    jv -java\r\n    ```\r\n\r\n## License\r\n\r\nMIT License\r\n\r\nCopyright (c) [Year] [Your Name]\r\n\r\nPermission is hereby granted, free of charge, to any person obtaining a copy\r\nof this software and associated documentation files (the \"Software\"), to deal\r\nin the Software without restriction, including without limitation the rights\r\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\r\ncopies of the Software, and to permit persons to whom the Software is\r\nfurnished to do so, subject to the following conditions:\r\n\r\nThe above copyright notice and this permission notice shall be included in all\r\ncopies or substantial portions of the Software.\r\n\r\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\r\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\r\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\r\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\r\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\r\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\r\nSOFTWARE.\r\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "JV-CLI is a lightweight command-line tool for managing Java environments. Easily switch between Java versions, set JAVA_HOME, persist changes, and configure multiple installations effortlessly.",
    "version": "1.0.0",
    "project_urls": {
        "Homepage": "https://github.com/sachin-acharya-projects/jv-cli"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "4fa4d45ce4b815ee1f19e86948150f3a719ecc81cb3508f92af2e537344bd41a",
                "md5": "ceb4442670879ee1ccf45977fda1aa74",
                "sha256": "f4b618781d1375a88f255eaefc5c873dca596328ab50b9936927161045e5aa2d"
            },
            "downloads": -1,
            "filename": "jv_env_cli-1.0.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "ceb4442670879ee1ccf45977fda1aa74",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.6",
            "size": 3905,
            "upload_time": "2025-02-09T11:18:49",
            "upload_time_iso_8601": "2025-02-09T11:18:49.229308Z",
            "url": "https://files.pythonhosted.org/packages/4f/a4/d45ce4b815ee1f19e86948150f3a719ecc81cb3508f92af2e537344bd41a/jv_env_cli-1.0.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "c7f903b61087c0664de72dc490ef37d1113e064378474252454ca2edc2b13a81",
                "md5": "8ab80b15cafefd784ea79d21095c6d42",
                "sha256": "9f78a745dc2e1123d8ed9144348cee9288ee97f73e6062e1b00dec7c9246243a"
            },
            "downloads": -1,
            "filename": "jv-env-cli-1.0.0.tar.gz",
            "has_sig": false,
            "md5_digest": "8ab80b15cafefd784ea79d21095c6d42",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.6",
            "size": 3835,
            "upload_time": "2025-02-09T11:18:50",
            "upload_time_iso_8601": "2025-02-09T11:18:50.927644Z",
            "url": "https://files.pythonhosted.org/packages/c7/f9/03b61087c0664de72dc490ef37d1113e064378474252454ca2edc2b13a81/jv-env-cli-1.0.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-02-09 11:18:50",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "sachin-acharya-projects",
    "github_project": "jv-cli",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "requirements": [
        {
            "name": "wheel",
            "specs": []
        }
    ],
    "lcname": "jv-env-cli"
}
        
Elapsed time: 1.42053s