Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/qw3rtman/p

:snake: Python Version Management Made Simple
https://github.com/qw3rtman/p

Last synced: 8 days ago
JSON representation

:snake: Python Version Management Made Simple

Host: GitHub
URL: https://github.com/qw3rtman/p
Owner: qw3rtman
License: mit
Created: 2015-05-05T05:29:39.000Z (over 9 years ago)
Default Branch: master
Last Pushed: 2019-11-01T07:04:46.000Z (about 5 years ago)
Last Synced: 2024-11-22T08:12:25.414Z (20 days ago)
Language: Shell
Homepage:
Size: 37.1 KB
Stars: 775
Watchers: 19
Forks: 46
Open Issues: 20
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

my-awesome-starred - p - :snake: Python Version Management Made Simple (Shell)
awesome-mine - p - Dead Simple Interactive Python Version Management. (Environment Management)
fucking_awesome_python - :octocat: p - :star: 578 :fork_and_knife: 25 - Dead simple interactive Python version management. (Environment Management)
awesome-python-cn - p
starred-awesome - p - :snake: Python Version Management Made Simple (Shell)
fucking-awesome-python-cn - p

README

# `p`
## Python Version Management, Simplified.

![introduction](https://cloud.githubusercontent.com/assets/1139621/7488032/37f37308-f389-11e4-8995-89f7cba5ad8b.gif)

`p` is **powerful** and **feature-packed**, yet **simple**; both in setup and use. There are no tricky settings, options, or crazy dependencies. `p` is just a helpful ~600 line Bash script that gets the job done.

**`p` let's you quickly switch between Python versions whenever you need to, removing the barrier between Python 2.x.x and 3.x.x.**

`p` was heavily inspired by [`n`, a version manager for Node.js](https://github.com/tj/n).

`p` is also great for getting started using Python development versions. Use `p latest` to get up and running with the latest development version of Python!

## Getting Started
After the [super painless drag-and-drop installation](#installation), you can [start using `p`](#usage) right away.

## Usage
```
Usage: p [COMMAND] [args]

Commands:

p Output versions installed
p status Output current status
p Activate to Python
p latest Activate to the latest Python release
p stable Activate to the latest stable Python release
p use [args ...] Execute Python with [args ...]
p bin Output bin path for
p rm Remove the given version(s)
p prev Revert to the previously activated version
p ls Output the versions of Python available
p ls latest Output the latest Python version available
p ls stable Output the latest stable Python version available

Options:

-V, --version Output current version of p
-h, --help Display help information
```

## Installation
After downloading the Bash script, simply copy it over to your `$PATH` and `p` will take care of the rest.
```sh
$ wget https://github.com/qw3rtman/p/releases/download/v0.1.0/p
$ chmod +x p
$ mv p /usr/local/bin
```

If you don't have `wget` on your system, you can download the `p` binary from the [releases page](https://github.com/qw3rtman/p/releases) and follow the above steps from the second one onward.

Alternatively, you can install `p` via `npm`:

```shell
npm install -g pyvm
```

So far, `p` has only been tested in Bash. If you can make `p` work on another shell, please send in a pull request!

## Updating
Simply follow the above steps and swap out the old Bash script with the new one!

## Contributing
Contributions are always welcome.

Find something interesting in the TODO below, fork our code, create a new branch, and send us a pull request.

There are only two rules: avoid [code smells](http://blog.codinghorror.com/code-smells/) and abide by the syntax-formatting of the existing code.

## TODO
* **greater abstraction between Python 2.x.x and 3.x.x**
* also manage pip
* per-directory/project Python version
* **also manage PyPy**

## FAQs
* How does `p` differ from [`pyenv`](https://github.com/yyuu/pyenv)?
* `p` is designed for the average Python user. You can get up and running with the latest development build of Python with one simple command: `p latest`. No configuration is necessary; `p` manages everything for you.
* On the other hand, `pyenv` is for the more advanced user who is comfortable configuring their Python environment to all their needs. `p` provides the basics in one easy to use aesthetically-pleasing command.
* Additionally, `p` is easier to use. To switch your Python version, simply run `p` and you'll be presented with a list of installed Python versions to select from that you can scroll through with your arrow keys and select with the return key.
* `p` is great at dealing with any version of Python. If it's not installed, running `p ` will download the source, configure it for your system, and compile it, all in one simple command.
* How does `p` work?
* `p` stores each Python version installed in `/usr/local/p/versions/python`. When a Python version is activated, `p` creates a symbolic link to the Python binary located at `/usr/local/p/versions/python/python`. Since `p` prefixes the $PATH with `/usr/local/p/versions/python`, this version of `python` is found first; hence, it is used over the default version of Python installed on your system.
* How do I revert back to my default Python version?
* Simply run `p default` and `p` will remove the symbolic link described above; therefore reverting back to your default Python version.
* Does `p` download the source each time I activate or install a version?
* Nope. `p` stores the source for each of the versions installed, allowing for quick activations between already-installed versions.
* How do I get this working on Windows?
* Unfortunately, `p` is not supported on Windows at the time. If you know of a workaround, send in a pull request!

## Core Team
### Nimit Kalra
* /
*
*
*

## License

The below license was included in [`n`](https://github.com/tj/n) and is included below. `p`'s license (also MIT) can be found in [the LICENSE file](https://github.com/qw3rtman/p/blob/master/LICENSE).

> (The MIT License)

> 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.