setV:पायथन वर्चुअल वातावरण बनाए रखने के लिए एक बैश फ़ंक्शन

एक साल से अधिक समय से, setV मेरे bash_scripts प्रोजेक्ट में छिपा हुआ है, लेकिन यह सार्वजनिक होने का समय है। setV एक बैश फ़ंक्शन है जिसका उपयोग मैं virtualenvwrapper के विकल्प के रूप में करता हूं। यह मूलभूत सुविधाएं प्रदान करता है जो आपको इस तरह के काम करने में सक्षम बनाती हैं:

• डिफ़ॉल्ट रूप से Python 3 का उपयोग करें
• एक नया आभासी वातावरण बनाएं
• -p . के साथ कस्टम पायथन पथ का उपयोग करके एक नया आभासी वातावरण बनाएं (या --अजगर )
• मौजूदा वर्चुअल परिवेश मिटाएं
• सभी मौजूदा आभासी वातावरण की सूची बनाएं
• टैब पूर्णता का उपयोग करें (यदि आपको वर्चुअल वातावरण का नाम याद नहीं है)

इंस्टॉलेशन

सेटवी स्थापित करने के लिए, स्क्रिप्ट डाउनलोड करें:

curl https://gitlab.com/psachin/setV/raw/master/install.sh

स्क्रिप्ट की समीक्षा करें, और फिर उसे चलाएँ:

sh ./install.sh

जब आप setV इंस्टॉल करते हैं, तो इंस्टॉलेशन स्क्रिप्ट आपसे ~/.bashrc . को सोर्स करने के लिए कहती है या ~/.bash_profile . ऐसा करना सुनिश्चित करें।

उपयोग

मूल आदेश setv . है ।

एक आभासी वातावरण बनाएं:

setv --new rango  # setv -n rango



# Or using a custom Python binary path

setv --new --python /opt/python/python3 rango  # setv -n -p /opt/python/python3 rango

मौजूदा परिवेश सक्रिय करें:

setv VIRTUAL_ENVIRONMENT_NAME



# For example

setv rango

सभी वर्चुअल परिवेशों की सूची बनाएं:

setv --list

# or

setv [TAB] [TAB]

आभासी वातावरण हटाएं:

setv --delete rango

दूसरे वर्चुअल वातावरण में स्विच करें:

# Assuming you are in 'rango', switch to 'tango' using

setv tango

टैब पूर्णता

यदि आपको वर्चुअल परिवेश का नाम पूरी तरह से याद नहीं है, तो बैश जैसा टैब पूर्णता वर्चुअल परिवेश नामों के लिए कार्य करता है।

शामिल हों

setV, GNU GPLv3 के तहत खुला स्रोत है, और योगदान का स्वागत है। अधिक जानने के लिए, इसके GitLab भंडार में setV के README के योगदान अनुभाग पर जाएं।

सेटवी स्क्रिप्ट

#!/usr/bin/env bash

# setV - A Lightweight Python virtual environment manager.

# Author: Sachin (psachin) <[email protected]>

# Author's URL: https://psachin.gitlab.io/about

#

# License: GNU GPL v3, See LICENSE file

#

# Configure(Optional):

# Set `SETV_VIRTUAL_DIR_PATH` value to your virtual environments

# directory-path. By default it is set to '~/virtualenvs/'

#

# Usage:

# Manual install: Added below line to your .bashrc or any local rc script():

# ---

# source /path/to/virtual.sh

# ---

#

# Now you can 'activate' the virtual environment by typing

# $ setv <YOUR VIRTUAL ENVIRONMENT NAME>

#

# For example:

# $ setv rango

#

# or type:

# setv [TAB] [TAB]  (to list all virtual envs)

#

# To list all your virtual environments:

# $ setv --list

#

# To create new virtual environment:

# $ setv --new new_virtualenv_name

#

# To delete existing virtual environment:

# $ setv --delete existing_virtualenv_name

#

# To deactivate, type:

# $ deactivate



# Path to virtual environment directory

SETV_VIRTUAL_DIR_PATH="$HOME/virtualenvs/"

# Default python version to use. This decides whether to use `virtualenv` or `python3 -m venv`

SETV_PYTHON_VERSION=3  # Defaults to Python3

SETV_PY_PATH=$(which python${SETV_PYTHON_VERSION})



function _setvcomplete_()

{

    # Bash-autocompletion.

    # This ensures Tab-auto-completions work for virtual environment names.

    local cmd="${1##*/}" # to handle command(s).

                         # Not necessary as such. 'setv' is the only command



    local word=${COMP_WORDS[COMP_CWORD]} # Words thats being completed

    local xpat='${word}'                 # Filter pattern. Include

                                         # only words in variable '$names'

    local names=$(ls -l "${SETV_VIRTUAL_DIR_PATH}" | egrep '^d' | awk -F " " '{print $NF}') # Virtual environment names



    COMPREPLY=($(compgen -W "$names" -X "$xpat" -- "$word")) # compgen generates the results

}



function _setv_help_() {

    # Echo help/usage message

    echo "Usage: setv [OPTIONS] [NAME]"

    echo Positional argument:

    echo -e "NAME                       Activate virtual env."

    echo Optional arguments:

    echo -e "-l, --list                 List all Virtual Envs."

    echo -e "-n, --new NAME             Create a new Python Virtual Env."

    echo -e "-d, --delete NAME          Delete existing Python Virtual Env."

    echo -e "-p, --python PATH          Python binary path."

}



function _setv_custom_python_path()

{

    if [ -f "${1}" ];

    then

        if [ "`expr $1 : '.*python\([2,3]\)'`" = "3" ];

        then

            SETV_PYTHON_VERSION=3

        else

            SETV_PYTHON_VERSION=2

        fi

        SETV_PY_PATH=${1}

        _setv_create $2

    else

        echo "Error: Path ${1} does not exist!"

    fi

}



function _setv_create()

{

    # Creates new virtual environment if ran with -n|--new flag

    if [ -z ${1} ];

    then

        echo "You need to pass virtual environment name"

        _setv_help_

    else

        echo "Creating new virtual environment with the name: $1"



        if [ ${SETV_PYTHON_VERSION} -eq 3 ];

        then

            ${SETV_PY_PATH} -m venv ${SETV_VIRTUAL_DIR_PATH}${1}

        else

            virtualenv -p ${SETV_PY_PATH} ${SETV_VIRTUAL_DIR_PATH}${1}

        fi



        echo "You can now activate the Python virtual environment by typing: setv ${1}"

    fi

}



function _setv_delete()

{

    # Deletes virtual environment if ran with -d|--delete flag

    # TODO: Refactor

    if [ -z ${1} ];

    then

        echo "You need to pass virtual environment name"

        _setv_help_

    else

        if [ -d ${SETV_VIRTUAL_DIR_PATH}${1} ];

        then

            read -p "Really delete this virtual environment(Y/N)? " yes_no

            case $yes_no in

                Y|y) rm -rvf ${SETV_VIRTUAL_DIR_PATH}${1};;

                N|n) echo "Leaving the virtual environment as it is.";;

                *) echo "You need to enter either Y/y or N/n"

            esac

        else

            echo "Error: No virtual environment found by the name: ${1}"

        fi

    fi

}



function _setv_list()

{

    # Lists all virtual environments if ran with -l|--list flag

    echo -e "List of virtual environments you have under ${SETV_VIRTUAL_DIR_PATH}:\n"

    for virt in $(ls -l "${SETV_VIRTUAL_DIR_PATH}" | egrep '^d' | awk -F " " '{print $NF}')

    do

        echo ${virt}

    done

}



function setv() {

    # Main function

    if [ $# -eq 0 ];

    then

        _setv_help_

    elif [ $# -le 3 ];

    then

        case "${1}" in

            -n|--new) _setv_create ${2};;

            -d|--delete) _setv_delete ${2};;

            -l|--list) _setv_list;;

            *) if [ -d ${SETV_VIRTUAL_DIR_PATH}${1} ];

               then

                   # Activate the virtual environment

                   source ${SETV_VIRTUAL_DIR_PATH}${1}/bin/activate

               else

                   # Else throw an error message

                   echo "Sorry, you don't have any virtual environment with the name: ${1}"

                   _setv_help_

               fi

               ;;

        esac

    elif [ $# -le 5 ];

    then

        case "${2}" in

            -p|--python) _setv_custom_python_path ${3} ${4};;

            *) _setv_help_;;

        esac

    fi

}



# Calls bash-complete. The compgen command accepts most of the same

# options that complete does but it generates results rather than just

# storing the rules for future use.

complete  -F _setvcomplete_ setv