Metadata-Version: 2.1
Name: pipx
Version: 0.14.0.0rc0
Summary: Install and Run Python Applications in Isolated Environments
Home-page: https://github.com/pipxproject/pipx
Author: Chad Smith
Author-email: grassfedcode@gmail.com
License: License :: OSI Approved :: MIT License
Description: <!---
        Do not edit this file. This file was rendered from the
        templates/ directory.
        See Contributing for how to update this file.
        --->
        <p align="center">
        <a href="https://pipxproject.github.io/pipx/">
        <img align="center" src="https://github.com/pipxproject/pipx/raw/master/logo.png"/>
        </a>
        </p>
        
        # pipx — Install and Run Python Applications in Isolated Environments
        
        <p align="center">
        <a href="https://github.com/pipxproject/pipx/raw/master/pipx_demo.gif">
        <img src="https://github.com/pipxproject/pipx/raw/master/pipx_demo.gif"/>
        </a>
        </p>
        
        <p align="center">
        <a href="https://travis-ci.org/pipxproject/pipx"><img src="https://travis-ci.org/pipxproject/pipx.svg?branch=master" /></a>
        </p>
        
        **Documentation**: https://pipxproject.github.io/pipx/
        
        **Source Code**: https://github.com/pipxproject/pipx
        
        _For comparison to other tools including pipsi, see the [comparisons](comparisons.md)._
        
        ## Install pipx
        
        ```
        python3 -m pip install --user pipx
        python3 -m pipx ensurepath
        ```
        
        For more details, [installation](installation).
        
        To add shell completions, see instructions with
        ```
        pipx completions
        ```
        
        ## Overview: What is `pipx`?
        
        pipx is a tool to help you install and run end-user applications written in Python. pipx **is not** a tool for development or publishing of your code. It's kind of like macOS's `brew` (if you are familiar with that), but for Python applications.
        
        Python and PyPI allow developers to distribute code with "console script entry points". These scripts let users call into Python code from the command line, effectively acting like standalone applications.
        
        `pipx` is a tool to install and run any of the thousands of Python applications available on PyPI in a safe, convenient, and reliable way. **In a way, it turns Python Package Index (PyPI) into a big app store for Python applications.** Not all Python packages have entry points, but many do.
        
        `pipx` enables you to:
        
        - Safely install packages to isolated environments, while globally exposing their CLI entry points so you can run them from anywhere (see the `install` command). This guarantees no dependency conflicts and clean uninstalls!
        - Easily list, upgrade, and uninstall packages that were installed with pipx
        - Run the latest version of a Python application in a temporary environment (see the `run` command)
        
        Best of all, pipx runs with regular user permissions, never calling `sudo pip install` (you aren't doing that, are you? 😄).
        
        pipx is similar to JavaScript's [npx](https://medium.com/@maybekatz/introducing-npx-an-npm-package-runner-55f7d4bd282b) - which ships with npm, but also allows you to install instead of just run. pipx does not ship with pip but installing it is often an important part of bootstrapping your system.
        
        ### Safely installing to isolated environments
        
        You can globally install an application by running
        
        ```
        pipx install PACKAGE
        ```
        
        This automatically creates a virtual environment, installs the package, and adds the package's associated applications (entry points) to a location on your `PATH`. For example, `pipx install pycowsay` makes the `pycowsay` command available globally, but sandboxes the pycowsay package in its own virtual environment. **pipx never needs to run as sudo to do this.**
        
        Example:
        
        ```
        >> pipx install pycowsay
          installed package pycowsay 2.0.3, Python 3.7.3
          These apps are now globally available
            - pycowsay
        done! ✨ 🌟 ✨
        
        
        >> pipx list
        venvs are in /home/user/.local/pipx/venvs
        apps are exposed on your $PATH at /home/user/.local/bin
           package pycowsay 2.0.3, Python 3.7.3
            - pycowsay
        
        
        >> pycowsay mooo
          ____
        < mooo >
          ====
                 \
                  \
                    ^__^
                    (oo)\_______
                    (__)\       )\/\
                        ||----w |
                        ||     ||
        
        
        ```
        
        ### Running in temporary, sandboxed environments
        
        pipx makes running the latest version of a program in a temporary environment as easy as
        
        ```
        pipx run APP [ARGS...]
        ```
        
        This will install the package in an isolated, temporary directory and invoke the app. Try it!
        
        ```
        pipx run pycowsay moo
        ```
        
        Notice that you **don't need to execute any install commands to run the app**.
        
        Re-running the same app is quick because pipx caches Virtual Environments on a per-app basis. These caches last two days.
        
        I find this handy when I want to quickly see the help text of an application, or when I occasionally run an app but don't necessarily want it hanging around on my system. A nice side benefit is that you don't have to remember to upgrade it since `pipx run` will automatically run a recent version for you.
        
        You can run .py files directly, too.
        
        ```
        pipx run https://gist.githubusercontent.com/cs01/fa721a17a326e551ede048c5088f9e0f/raw/6bdfbb6e9c1132b1c38fdd2f195d4a24c540c324/pipx-demo.py
        pipx is working!
        ```
        
        ## Testimonials
        
        "*I'm a big fan of pipx. I think pipx is super cool.*"
        <div style="text-align: right; margin-right: 10%;">
        —<a href="https://twitter.com/mkennedy">Michael Kennedy</a>, co-host of PythonBytes podcast in <a href="https://pythonbytes.fm/episodes/transcript/139/f-yes-for-the-f-strings">episode 139</a>
        </div>
        
        "*Thanks for improving the workflow that pipsi has covered in the past. Nicely done!*"
        <div style="text-align: right; margin-right: 10%;">
        —<a href="https://twitter.com/jezdez">Jannis Leidel</a>, PSF fellow and former pip maintainer
        </div>
        
        "*This tool filled in the gap that was missing with pipenv and Virtual Environmentwrapper.*"
        <div style="text-align: right; margin-right: 10%;">
        —Mason Egger in a <a href="https://medium.com/homeaway-tech-blog/simplify-your-python-developer-environment-aba90f32dddb">blog post</a>
        </div>
        
        
        ## Credits
        
        pipx was inspired by [pipsi](https://github.com/mitsuhiko/pipsi) and [npx](https://github.com/zkat/npx).
        
        Creator/Maintainer
        
        - [Chad Smith](https://github.com/cs01/)
        
        Contributors
        
        - [Bjorn Neergaard](https://github.com/neersighted)
        - [Diego Fernandez](https://github.com/aiguofer)
        - [Jason R. Coombs](https://github.com/jaraco)
        - [joshuarli](https://github.com/joshuarli)
        - [tkossak](https://github.com/tkossak)
        - [Tzu-ping Chung](https://github.com/uranusjr)
        - [Shawn Hensley](https://github.com/sahensley)
Keywords: pip,install,cli,workflow,Virtual Environment
Platform: UNKNOWN
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3 :: Only
Requires-Python: >=3.6
Description-Content-Type: text/markdown
