Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/justinmayer/virtualfish

Fish shell tool for managing Python virtual environments
https://github.com/justinmayer/virtualfish

fish fish-shell python shell virtualenv virtualenvwrapper

Last synced: 3 days ago
JSON representation

Fish shell tool for managing Python virtual environments

Awesome Lists containing this project

README

        

# VirtualFish

[![Build Status](https://img.shields.io/github/actions/workflow/status/justinmayer/virtualfish/main.yml?branch=main)](https://github.com/justinmayer/virtualfish/actions)
[![PyPI Version](https://img.shields.io/pypi/v/virtualfish)](https://pypi.org/project/virtualfish/)
[![Downloads](https://img.shields.io/pypi/dm/virtualfish)](https://pypi.org/project/virtualfish/)

VirtualFish is a Python [virtual environment][Virtualenv] manager for the [Fish shell][].

You can get started by [reading the documentation][Read The Docs]. (It’s quite short… Promise!)

You can also get help on [#virtualfish on OFTC](https://webchat.oftc.net/?randomnick=1&channels=virtualfish) (`ircs://irc.oftc.net:6697/#virtualfish`), the same network as the [Fish IRC channel](https://webchat.oftc.net/?randomnick=1&channels=fish).

VirtualFish is maintained by [Justin Mayer](https://justinmayer.com/), and was originally created by [Daisy Leigh Brenecki](https://daisy.wtf).

## A quickstart, for the impatient

👉 **Fish version 3.1 or higher is required.** 👈

1. `python -m pip install virtualfish`
2. `vf install`
3. [Add VirtualFish to your prompt](https://virtualfish.readthedocs.org/en/latest/install.html#customizing-your-fish-prompt)
4. `vf new myvirtualenv; which python`

[Read the documentation][Read The Docs] to find out more about project management, environment variable automation, auto-activation, and other plugins, as well as extending VirtualFish with events, [virtualenvwrapper][] emulation, and more.

[Virtualenv]: https://virtualenv.pypa.io/en/latest/
[Fish shell]: https://fishshell.com/
[Read The Docs]: https://virtualfish.readthedocs.org/en/latest/
[virtualenvwrapper]: https://bitbucket.org/virtualenvwrapper/virtualenvwrapper