Флаг Хаоса — Литания против страха

Спасено с умученного Ютубовскими цензорами старого канала [info]paperdaemon@ljr, и эта литания действительно помогает.

Инструкция по использованию простая — сосредоточьтесь на своих страхах, запустите видео и смотрите в центр Черного Солнца.

Кстати, основываясь на своем опыте — этот мини-ритуал помогает вполне себе в реальности. Не буду разглашать подробности, тому ще мои личные проблемы никому не нужны.

Прямая ссылка: https://youtu.be/TKPgA_UJYfg

Как добавить картинку в readme на GitHub

Очередная заметка «от склероза». Товарищ [info]is3@ljr посоветовал добавить скриншоты в readme проекта ASCII-капчи, а я ж, как обычно, мануалы читаю в последнюю очередь, и даже не знал о такой возможности. А она есть.

1. Грузим картинки на GitHub, желательно в отдельный каталог, например screnshoots. Лучше грузить скрины в сам репозиторий, хотя GitHub позволяет вставку картинок и с других сайтов.

2. Добавляем следующий код в README.md:

![Описание](http(s)://адрес_картинки.png(jpg))

3. Пример:

# Screenshoots

ASCII captcha:

![ASCII captcha](https://raw.githubusercontent.com/tolik-punkoff/ascii-captcha/master/screnshoots/test01.png)

ASCII captcha on real HTML page:

![ASCII captcha on real HTML page](https://raw.githubusercontent.com/tolik-punkoff/ascii-captcha/master/screnshoots/on_page1.png)

User send wrong code:

![User send wrong code](https://raw.githubusercontent.com/tolik-punkoff/ascii-captcha/master/screnshoots/on_page2_wrong%20code.png)

Правда описание у меня нигде не всплыло, но наверное потому, что я использовал браузер в параноидальном режиме, без js.

Простой интерактив в bash-скриптах, часть 2. Списки (меню).

Преамбула

В bash-скрипте можно организовать простое меню, в виде списка, и предоставить пользователю выбор из нескольких вариантов.
Список вариантов можно сформировать вручную, просто перечислив нужные в скрипте. Другой способ — сформировать список динамически, так, как это, например, описано здесь копия. Покажу второй способ.

Сначала возьмем из скрипта по ссылке выше функцию create_list() и необходимые переменные:

FOUNDLST=""
DIR1="/home/smallwolfie/test/archives"
TARGZ=""

create_list() #$1 - dir, $2 - file mask
{
    FOUNDLST=""
    for FLE in $(find $1 -maxdepth 1 -iname $2); do
	if [ -n "$FLE" ]; then
	    FOUNDLST="$FOUNDLST"`basename $FLE`"\n"
	fi
    done
}
#тут будет функция вывода списка
#...
#создаем список
create_list $DIR1 "*.tar.gz"

if [ -z "$FOUNDLST" ]; then
    echo "$DIR1 *.tar.gz not found"
    exit
else
    TARGZ="$FOUNDLST"
fi

Простой вариант с помощью оператора select.

Организуем это дело в виде отдельной функции ask_list(), куда первым параметром передается список, а вторым — запрос для пользователя.

1. Скопируем содержимое первого параметра в переменную $LIST_BUF, со списком придется сделать несколько преобразований:

LIST_BUF=$1

2. Список у меня в виде строк, разделенных стандартным переносом \n, так что заодно добавлю пункт Cancel, чтобы пользователь мог отказаться от выбора.

LIST_BUF="$LIST_BUF""Cancel"

3. Оператор select работает со списком значений, разделенных пробелами, так что надо символы \n заменить на пробелы:

LIST_BUF=`echo -e "$LIST_BUF"|sed 's/\n/ /'`

4. Устанавливаем подсказку ввода для пользователя, присвоив второй параметр функции специальной переменной PS3.

PS3=$2

5. Теперь используем оператор select:

echo
    select LIST_RET in $LIST_BUF; do
	if [ -n "$LIST_RET" ];then
	    break
	fi
    done

На экран будет выведен список, а пользователю будет предложено ввести номер из списка:

smallwolfie@wolfschanze: ~/test/$ ./asklist2

1) slinstall.tar.gz 3) teSt.Tar.gZ 5) Cancel
2) slmini.tar.gz 4) TEST.TAR.GZ
Select file:

Если внутри конструкции select..done не поставить break, то цикл выбора окажется бесконечным.
Значение (строка после номера) будет записано в переменную, указанную после ключевого слова select.
Если пользователь введет номер не из списка, или вообще что-то левое, то переменная $LIST_RET окажется пустой.
Здесь внутри конструкции select..done добавлена конструкция для проверки этого. Если переменная окажется пустой — пользователю будет предложено повторить ввод:

smallwolfie@wolfschanze: ~/test/$ ./asklist-select

1) slinstall.tar.gz 3) teSt.Tar.gZ 5) Cancel
2) slmini.tar.gz 4) TEST.TAR.GZ
Select file: blablabla
Select file:

Функция целиком:

ask_list() #$1 - list #$2 - header
{
    LIST_BUF=$1
    LIST_BUF="$LIST_BUF""Cancel"
    LIST_BUF=`echo -e "$LIST_BUF"|sed 's/\n/ /'`
    
    PS3=$2
    
    echo
    select LIST_RET in $LIST_BUF; do
	if [ -n "$LIST_RET" ];then
	    break
	fi
    done
    
}

Пример вызова функции:

ask_list "$TARGZ" "Select file: "

if [[ "$LIST_RET" == "Cancel" ]]; then
    echo "Cancelled by user!"
    exit
fi

echo "User select: $LIST_RET"

Результат:

smallwolfie@wolfschanze: ~/test/$ ./asklist-select

1) slinstall.tar.gz 3) teSt.Tar.gZ 5) Cancel
2) slmini.tar.gz 4) TEST.TAR.GZ
Select file: 5
Cancelled by user!

smallwolfie@wolfschanze: ~/test/$ ./asklist-select

1) slinstall.tar.gz 3) teSt.Tar.gZ 5) Cancel
2) slmini.tar.gz 4) TEST.TAR.GZ
Select file: 3
User select: teSt.Tar.gZ

Скрипт на GitHub
Скрипт на PasteBin

Второй вариант, быдлокодерский, с жирным башизмом, более длинный, но красивее смотрится на экране.

Под катом

Источники

Взаимодействие bash-скриптов с пользователем. Часть 2

Простой интерактив в bash-скриптах

Преамбула

Иногда полезно иметь в своих скриптах элемент интерактивного взаимодействия с пользователем, например, запросить с клавиатуры некую строку (путь, пароль, имя пользователя и т.д.), или получить от пользователя подтверждение действия (Вы уверены? [Y/n]). Далее покажу простейшие случаи.

Ввод строки

Все, кто хоть раз пользовался для создания нового пользователя скриптом adduser, наблюдали на экране следующую картину:

Login name for new user []: wolfkid

User ID ('UID') [ defaults to next available ]:

Initial group [ users ]:
...
Home directory [ /home/wolfkid ]

Shell [ /bin/bash ]

Expiry date (YYYY-MM-DD) []:

Понятно, что где-то можно (и нужно) ввести свои данные, а где-то согласиться с предлагаемыми скриптом по умолчанию (или не согласиться, ввести свое).

Вопрос, как такое сделать в своем скрипте?

В данном случае можно воспользоваться командой read.

Общий синтаксис:

read [ПАРАМЕТРЫ] [ПЕРЕМЕННАЯ]

Если имя переменной не будет указано, то, что было введено с клавиатуры попадет в специальную переменную $REPLY.

Обратите внимание: в команду read имя переменной подставляется без символа $. Т.е. если вы хотите, чтоб введенная строка оказалась в переменной VAR1, то синтаксис такой:

read VAR1

Функция для ввода строки с возможностью оставить значение по умолчанию.

Напишем функцию, которая будет принимать два параметра — строку с пояснением, что мы хотим, чтоб пользователь ввел, и строку, которая будет представлять значение по умолчанию. В случае, если пользователь что-то ввел, то функция запишет в переменную $STR_RESULT новое значение. Если же пользователь просто нажмет Enter, то в $STR_RESULT будет записано значение, переданное во втором параметре.

ask_string() #1-user ask string, #2-default variant
{
    read -r -p "$1 [$2]:"
    
    if [ -z "$REPLY" ]; then
	if [ -n "$2" ]; then
	    STR_RESULT=$2
	fi
    else
	STR_RESULT=$REPLY
    fi
}

Небольшое пояснение по используемым параметрам read:

-r — отключает режим интерпретации эскейп-последовательностей, т.е. \n, \r, \t и т.д. не будут записаны в переменную, как символы возврата каретки, перевода строки или табуляции, а будут восприниматься, как символьные последовательности — слэш и буква.
-p [СООБЩЕНИЕ]СООБЩЕНИЕ, это строка, которая будет выведена пользователю перед тем, как он сможет ввести данные.

Пример вызова функции:

ask_string "Select path" "/home/smallwolfie/test/testdir"
echo $STR_RESULT

Вывод:
Пользователь нажал Enter, оставив значение по умолчанию:
smallwolfie@wolfschanze:~/test/input01$ ./askstring
Select path [/home/smallwolfie/test/testdir]:
/home/smallwolfie/test/testdir

Пользователь ввел другое значение:
smallwolfie@wolfschanze:~/test/input01$ ./askstring
Select path [/home/smallwolfie/test/testdir]:/tmp
/tmp

Готовый скрипт на GitHub
Готовый скрипт на PasteBin

Запрос Да/Нет

Обычный запрос Вы уверены [Y/N]. Для удобства использования (т.е. копипаста в другие скрипты) тоже можно реализовать в виде отдельной функции, которой передается один параметр — строка с вопросом для пользователя:

ask_y_n() #$1 - question
{
    echo -n "$1 [Y/N]: "
    while [ 1 -eq 1 ];do
	read -s -n1
	
	case "$REPLY" in
	    [yY])
		echo
		return 0
	    ;;
	    [nN])
		echo
		return 1
	    ;;
	esac
    done
}

Пояснения:

1. Командой echo -n "$1 [Y/N]: " выводим пользователю сообщение с пояснением, что надо нажать (Y или N). Параметр -n в команде echo запрещает ей переводить курсор на новую строку. Опцией -p команды read не пользуемся для красоты, иначе сообщение будет выскакивать при каждом нажатии клавиши, и заполнять экран.
2. Организуем бесконечный цикл:
while [ 1 -eq 1 ];do
#...
done

Единица всегда равна единице, поэтому цикл не завершится, если не будет какого-то прерывания внутри цикла.
3. В начале цикла вставляем команду read со следующими параметрами:
-s — не отображать вводимые пользователем символы на экране
-n1 — читать 1 символ, и завершаться, не дожидаясь нажатия клавиши Enter.
4. Далее в операторе case проверяем, что было нажато: если Y или y, то пользователь ответил «да», если N или n — «нет». Ну не заставлять же пользователя регистр символов отдельно проверять… Возвращаем соответствующий код возврата 0 для «да», 1 для «нет»

Пример вызова функции:

ask_y_n "Run it?"

if [ "$?" -eq 0 ];then
    echo "User ask YES!"
else
    echo "User ask NO :("
fi

Вывод:

Пользователь не нажал ничего, или нажал что-нибудь кроме YyNn:

smallwolfie@wolfschanze:~/test/input02$ ./askyn
Run it? [Y/N]:

Пользователь ответил «Нет»:
smallwolfie@wolfschanze:~/test/input02$ ./askyn
Run it? [Y/N]:
User ask NO :(

Пользователь ответил «Да»:

smallwolfie@wolfschanze:~/test/input02$ ./askyn
Run it? [Y/N]:
User ask YES :)

Скрипт на GitHub
Скрипт на PasteBin

Источники

Внутренние команды bash