uvx


Nameuvx JSON
Version 2.0.8 PyPI version JSON
download
home_pageNone
Summaryuvx: pipx for uv (🦀)
upload_time2024-05-01 11:28:59
maintainerNone
docs_urlNone
authorNone
requires_pythonNone
licenseMIT
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # uvx: pipx for uv

Inspired by:

- [pipx](https://github.com/pypa/pipx)
- [uv](https://github.com/astral-sh/uv)

## Installation

1. Install via pip (or alternatives):
    ```bash
    pip install uvx  # or `uv`, `pipx`
    ```

2. Optional (for bash users):
    - Ensure that `~/.local/bin` is in your PATH:
        ```bash
        uvx ensurepath
        ```
    - Enable tab completion for `uvx`:
        ```bash
        uvx completions --install
        ```

## Usage

```bash
uvx
```

Run `uvx` without any arguments to see all possible subcommands.

## Platform Considerations

- **Rust-Powered Performance (uvx 2.0):** Starting from version 2.0, `uvx` leverages Rust for improved performance and
  compatibility with `uv`.
- **Prebuilt Binaries:** Currently, prebuilt binaries are available for x86_64 (amd64) and aarch64 (ARM64) on Linux.
- **Other Platforms:** If you're on a different platform, you can still use `uvx 1.x`, which is written in pure Python.
  Find it at [robinvandernoord/uvx](https://github.com/robinvandernoord/uvx).
- Alternatively, you can **Compile for Your Platform**:
    - Install the Rust toolchain:
        ```bash
        curl https://sh.rustup.rs -sSf | sh
        ```
    - Clone the `uvx2` repo and navigate to it:
        ```bash
        git clone https://github.com/robinvandernoord/uvx2.git
        cd uvx2
        ```
    - Set up a virtual environment (choose Python or uv):
        ```bash
        python -m venv venv  # or `uv venv venv --seed`
        source venv/bin/activate
        ```
    - Install Maturin (Python with Rust package builder):
        ```bash
        pip install maturin  # or `uv pip install maturin`
        ```
    - Compile and install the `uvx` binary:
        ```bash
        maturin develop
        ```
    - Now you can use `uvx`:
        ```bash
        ./venv/bin/uvx
        ```

For additional details on building and distribution, refer to [maturin](https://www.maturin.rs/distribution)
documentation.

## License

`uvx` is distributed under the terms of the [MIT](https://spdx.org/licenses/MIT.html) license.

## Changelog

See `CHANGELOG.md` [on GitHub](https://github.com/robinvandernoord/uvx2/blob/master/CHANGELOG.md)


            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "uvx",
    "maintainer": null,
    "docs_url": null,
    "requires_python": null,
    "maintainer_email": null,
    "keywords": null,
    "author": null,
    "author_email": "Robin van der Noord <robinvandernoord@gmail.com>",
    "download_url": "https://files.pythonhosted.org/packages/f9/bf/bcf8427c34a80ef334b09eabf850ffb196de68ef802264e825c305bef387/uvx-2.0.8.tar.gz",
    "platform": null,
    "description": "# uvx: pipx for uv\n\nInspired by:\n\n- [pipx](https://github.com/pypa/pipx)\n- [uv](https://github.com/astral-sh/uv)\n\n## Installation\n\n1. Install via pip (or alternatives):\n    ```bash\n    pip install uvx  # or `uv`, `pipx`\n    ```\n\n2. Optional (for bash users):\n    - Ensure that `~/.local/bin` is in your PATH:\n        ```bash\n        uvx ensurepath\n        ```\n    - Enable tab completion for `uvx`:\n        ```bash\n        uvx completions --install\n        ```\n\n## Usage\n\n```bash\nuvx\n```\n\nRun `uvx` without any arguments to see all possible subcommands.\n\n## Platform Considerations\n\n- **Rust-Powered Performance (uvx 2.0):** Starting from version 2.0, `uvx` leverages Rust for improved performance and\n  compatibility with `uv`.\n- **Prebuilt Binaries:** Currently, prebuilt binaries are available for x86_64 (amd64) and aarch64 (ARM64) on Linux.\n- **Other Platforms:** If you're on a different platform, you can still use `uvx 1.x`, which is written in pure Python.\n  Find it at [robinvandernoord/uvx](https://github.com/robinvandernoord/uvx).\n- Alternatively, you can **Compile for Your Platform**:\n    - Install the Rust toolchain:\n        ```bash\n        curl https://sh.rustup.rs -sSf | sh\n        ```\n    - Clone the `uvx2` repo and navigate to it:\n        ```bash\n        git clone https://github.com/robinvandernoord/uvx2.git\n        cd uvx2\n        ```\n    - Set up a virtual environment (choose Python or uv):\n        ```bash\n        python -m venv venv  # or `uv venv venv --seed`\n        source venv/bin/activate\n        ```\n    - Install Maturin (Python with Rust package builder):\n        ```bash\n        pip install maturin  # or `uv pip install maturin`\n        ```\n    - Compile and install the `uvx` binary:\n        ```bash\n        maturin develop\n        ```\n    - Now you can use `uvx`:\n        ```bash\n        ./venv/bin/uvx\n        ```\n\nFor additional details on building and distribution, refer to [maturin](https://www.maturin.rs/distribution)\ndocumentation.\n\n## License\n\n`uvx` is distributed under the terms of the [MIT](https://spdx.org/licenses/MIT.html) license.\n\n## Changelog\n\nSee `CHANGELOG.md` [on GitHub](https://github.com/robinvandernoord/uvx2/blob/master/CHANGELOG.md)\n\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "uvx: pipx for uv (\ud83e\udd80)",
    "version": "2.0.8",
    "project_urls": null,
    "split_keywords": [],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "0a183b0e2e3c33eeadd70c1a80ebbdbb9e54d094707341d4fdf0b5a460232a63",
                "md5": "218eec3feb05b8af5eee4541b2d6fc8f",
                "sha256": "9042239481e71642a541da652cca4f940e0929ade0c0dcf906458a152475212e"
            },
            "downloads": -1,
            "filename": "uvx-2.0.8-py3-none-manylinux_2_34_aarch64.whl",
            "has_sig": false,
            "md5_digest": "218eec3feb05b8af5eee4541b2d6fc8f",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 2058787,
            "upload_time": "2024-05-01T11:28:53",
            "upload_time_iso_8601": "2024-05-01T11:28:53.867248Z",
            "url": "https://files.pythonhosted.org/packages/0a/18/3b0e2e3c33eeadd70c1a80ebbdbb9e54d094707341d4fdf0b5a460232a63/uvx-2.0.8-py3-none-manylinux_2_34_aarch64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "f2df2e0a162eb1e5cb361141ebea08418fb4d71463ad1597dabcf4d4af46cc3e",
                "md5": "89baf3068a82f93b4113be1bd33f612f",
                "sha256": "58a6d651af6153b1fc3cc94e753fda9f53815187db95a79115745dcbd354b4f8"
            },
            "downloads": -1,
            "filename": "uvx-2.0.8-py3-none-manylinux_2_34_x86_64.whl",
            "has_sig": false,
            "md5_digest": "89baf3068a82f93b4113be1bd33f612f",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 2194627,
            "upload_time": "2024-05-01T11:28:57",
            "upload_time_iso_8601": "2024-05-01T11:28:57.372883Z",
            "url": "https://files.pythonhosted.org/packages/f2/df/2e0a162eb1e5cb361141ebea08418fb4d71463ad1597dabcf4d4af46cc3e/uvx-2.0.8-py3-none-manylinux_2_34_x86_64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "f9bfbcf8427c34a80ef334b09eabf850ffb196de68ef802264e825c305bef387",
                "md5": "22461acd97a22d74f1eeb754865fd91e",
                "sha256": "5ba2de2ce4906315a9e2274f86bb6e50ed844641b42b39b9a76a6b5b80e59c21"
            },
            "downloads": -1,
            "filename": "uvx-2.0.8.tar.gz",
            "has_sig": false,
            "md5_digest": "22461acd97a22d74f1eeb754865fd91e",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 45478,
            "upload_time": "2024-05-01T11:28:59",
            "upload_time_iso_8601": "2024-05-01T11:28:59.901278Z",
            "url": "https://files.pythonhosted.org/packages/f9/bf/bcf8427c34a80ef334b09eabf850ffb196de68ef802264e825c305bef387/uvx-2.0.8.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-05-01 11:28:59",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "uvx"
}
        
Elapsed time: 0.25603s