Computer >> Hướng Dẫn Máy Tính >  >> Lập Trình >> Lập Trình Bash

SetV: Công cụ Bash hiệu quả để quản lý môi trường ảo Python

Hơn một năm qua, setV đã được ẩn trong dự án bash_scripts của tôi, nhưng đã đến lúc nó nên được công khai. setV là một hàm Bash mà tôi sử dụng như một giải pháp thay thế cho virtualenvwrapper. Nó cung cấp các tính năng cơ bản cho phép bạn thực hiện các việc sau:

  • Mặc định sử dụng Python 3
  • Tạo môi trường ảo mới
  • Tạo môi trường ảo mới với đường dẫn Python tùy chỉnh bằng -p (hoặc --python)
  • Xóa môi trường ảo hiện có
  • Liệt kê tất cả môi trường ảo hiện có
  • Hỗ trợ tự động hoàn thành Tab (trường hợp bạn không nhớ tên môi trường ảo)

Cài đặt

Để cài đặt setV, hãy tải xuống tập tin cài đặt:

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

Xem lại tập tin, sau đó chạy nó:

sh ./install.sh

Khi cài đặt setV, tập tin cài đặt sẽ yêu cầu bạn nạp (source) ~/.bashrc hoặc ~/.bash_profile. Hãy chắc chắn làm điều đó.

Sử dụng

Lệnh cơ bản là setv.

Tạo môi trường ảo mới:

setv --new rango # setv -n rango

# Hoặc sử dụng đường dẫn Python tùy chỉnh
setv --new --python /opt/python/python3 rango # setv -n -p /opt/python/python3 rango

Kích hoạt môi trường ảo hiện có:

setv TEN_MOI_TRUONG_AO

# Ví dụ
setv rango

Liệt kê tất cả môi trường ảo:

setv --list
# hoặc
setv [TAB] [TAB]

Xóa môi trường ảo:

setv --delete rango

Chuyển sang môi trường ảo khác:

# Giả sử bạn đang ở 'rango', chuyển sang 'tango' bằng
setv tango

Tự động hoàn thành Tab

Nếu bạn không nhớ đầy đủ tên môi trường ảo, tính năng tự động hoàn thành Tab kiểu Bash sẽ hoạt động cho tên môi trường ảo.

Đóng góp

setV là mã nguồn mở theo giấy phép GNU GPLv3, và các đóng góp đều được chào đón. Để tìm hiểu thêm, hãy truy cập phần Contribute trong README của setV trên kho GitLab.

Mã nguồn setV

#!/usr/bin/env bash
# setV - Trình quản lý môi trường ảo Python nhẹ.
# Tác giả: Sachin (psachin) <iclcoolster@gmail.com>
# URL tác giả: https://psachin.gitlab.io/about
#
# Giấy phép: GNU GPL v3, xem file LICENSE
#
# Cấu hình (Tùy chọn):
# Đặt giá trị `SETV_VIRTUAL_DIR_PATH` thành thư mục chứa
# môi trường ảo của bạn. Mặc định là '~/virtualenvs/'
#
# Cách dùng:
# Cài đặt thủ công: Thêm dòng dưới vào .bashrc hoặc file rc cục bộ:
# ---
# source /path/to/virtual.sh
# ---
#
# Bây giờ bạn có thể 'kích hoạt' môi trường ảo bằng cách gõ
# $ setv <TÊN MÔI TRƯỜNG ẢO CỦA BẠN>
#
# Ví dụ:
# $ setv rango
#
# hoặc gõ:
# setv [TAB] [TAB] (để liệt kê tất cả env ảo)
#
# Để liệt kê tất cả môi trường ảo:
# $ setv --list
#
# Tạo môi trường ảo mới:
# $ setv --new ten_moi_truong_ao_moi
#
# Xóa môi trường ảo hiện có:
# $ setv --delete ten_moi_truong_ao_ton_tai
#
# Để hủy kích hoạt, gõ:
# $ deactivate

# Đường dẫn thư mục môi trường ảo
SETV_VIRTUAL_DIR_PATH="$HOME/virtualenvs/"
# Phiên bản Python mặc định. Quyết định dùng `virtualenv` hay `python3 -m venv`
SETV_PYTHON_VERSION=3 # Mặc định Python3
SETV_PY_PATH=$(which python${SETV_PYTHON_VERSION})

function _setvcomplete_()
{
# Tự động hoàn thành Bash.
# Đảm bảo Tab tự động hoàn thành hoạt động cho tên môi trường ảo.
local cmd="${1##*/}" # xử lý lệnh.
# Không cần thiết lắm. 'setv' là lệnh duy nhất

local word=${COMP_WORDS[COMP_CWORD]} # Từ đang được hoàn thành
local xpat='${word}' # Mẫu lọc. Chỉ bao gồm
# các từ trong biến '$names'
local names=$(ls -l "${SETV_VIRTUAL_DIR_PATH}" | egrep '^d' | awk -F " " '{print $NF}') # Tên môi trường ảo

COMPREPLY=($(compgen -W "$names" -X "$xpat" -- "$word")) # compgen tạo kết quả
}

function _setv_help_() {
# Hiển thị thông báo trợ giúp/cách dùng
echo "Cách dùng: setv [TÙY CHỌN] [TÊN]"
echo Tham số vị trí:
echo -e "TÊN Kích hoạt môi trường ảo."
echo Tham số tùy chọn:
echo -e "-l, --list Liệt kê tất cả Env ảo."
echo -e "-n, --new TÊN Tạo môi trường ảo Python mới."
echo -e "-d, --delete TÊN Xóa môi trường ảo Python hiện có."
echo -e "-p, --python ĐƯỜNG_DẪN Đường dẫn nhị phân Python."
}

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 "Lỗi: Đường dẫn ${1} không tồn tại!"
fi
}

function _setv_create()
{
# Tạo môi trường ảo mới nếu chạy với cờ -n|--new
if [ -z ${1} ];
then
echo "Bạn cần truyền tên môi trường ảo"
_setv_help_
else
echo "Đang tạo môi trường ảo mới với tên: $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 "Bây giờ bạn có thể kích hoạt môi trường ảo Python bằng cách gõ: setv ${1}"
fi
}

function _setv_delete()
{
# Xóa môi trường ảo nếu chạy với cờ -d|--delete
# TODO: Tái cấu trúc
if [ -z ${1} ];
then
echo "Bạn cần truyền tên môi trường ảo"
_setv_help_
else
if [ -d ${SETV_VIRTUAL_DIR_PATH}${1} ];
then
read -p "Thực sự xóa môi trường ảo này (Y/N)? " yes_no
case $yes_no in
Y|y) rm -rvf ${SETV_VIRTUAL_DIR_PATH}${1};;
N|n) echo "Giữ nguyên môi trường ảo.";;
*) echo "Bạn cần nhập Y/y hoặc N/n"
esac
else
echo "Lỗi: Không tìm thấy môi trường ảo tên: ${1}"
fi
fi
}

function _setv_list()
{
# Liệt kê tất cả môi trường ảo nếu chạy với cờ -l|--list
echo -e "Danh sách môi trường ảo bạn có dưới ${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() {
# Hàm chính
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
# Kích hoạt môi trường ảo
source ${SETV_VIRTUAL_DIR_PATH}${1}/bin/activate
else
# Ném thông báo lỗi
echo "Xin lỗi, bạn không có môi trường ảo nào tên: ${1}"
_setv_help_
fi
;;
esac
elif [ $# -le 5 ];
then
case "${2}" in
-p|--python) _setv_custom_python_path ${3} ${4};;
*) _setv_help_;;
esac
fi
}

# Gọi bash-complete. Lệnh compgen chấp nhận hầu hết các tùy chọn
# giống như complete nhưng nó tạo kết quả thay vì chỉ lưu quy tắc.
complete -F _setvcomplete_ setv