Линия чтения GNU

Линия чтения GNU

Оригинальный автор(ы)	Брайан Фокс
Разработчик(и)	Chet Ramey
Первоначальный выпуск	1989 год ( 1989 )
Стабильная версия	8.2   / 26 сентября 2022 г.
Репозиторий	мерзавец .саванна .gnu .org /cgit /readline .git
Написано в	С
Тип	Библиотека
Лицензия	2009: GPL-3.0 или новее 1997: GPL-2.0 или более поздняя версия 1994: GPL-1.0 или более поздняя версия
Веб-сайт	www .gnu .org /программное обеспечение /readline /

GNU Readline — это программная библиотека , которая обеспечивает возможности оперативного редактирования и истории для интерактивных программ с интерфейсом командной строки , таких как Bash . В настоящее время его поддерживает Чет Рэми как часть проекта GNU .

Он позволяет пользователям перемещать текстовый курсор , выполнять поиск в истории команд , управлять кольцом уничтожения (более гибкая версия буфера обмена копирования/вставки) и использовать завершение табуляции на текстовом терминале . Будучи кросс-платформенной библиотекой, readline позволяет приложениям в различных системах демонстрировать одинаковое поведение при редактировании строк.

Режимы редактирования

Readline поддерживает режимы редактирования Emacs и vi, которые определяют, как ввод с клавиатуры интерпретируется как команды редактора. См. Editor war § Сравнение .

Сочетания клавиш Emacs

режима редактирования Emacs Привязки клавиш взяты из текстового редактора Emacs .

В некоторых системах Esc необходимо использовать вместо Alt, потому что Alt ярлык конфликтует с другим ярлыком. Например, нажав Alt+ f в окне эмулятора терминала Xfce не перемещает курсор вперед на одно слово, а активирует «Файл» в меню окна терминала, если это не отключено в настройках эмулятора.

• Tab ↹ : автозаполнение с позиции курсора.
• Ctrl+ a : перемещает курсор в начало строки (эквивалентно клавише Home).
• Ctrl+ b : перемещает курсор на один символ назад (эквивалентно клавише ←).
• Ctrl+ c : отправляет сигнал SIGINT через псевдотерминал текущей задаче, которая прерывает и закрывает ее.
• Ctrl+ d
  • Отправляет маркер EOF, который (если не отключен опцией) закрывает текущую оболочку (эквивалентно команде exit). (Только если в текущей строке нет текста)
  • Если в текущей строке есть текст, удаляет текущий символ (тогда эквивалентный клавише Delete).
• Ctrl+ e : ( end ) перемещает курсор в конец строки (эквивалентно клавише End).
• Ctrl+ f : перемещает курсор на один символ вперед (эквивалентно клавише →).
• Ctrl+ g : Прервать обратный поиск и восстановить исходную строку.
• Ctrl+ h : удаляет предыдущий символ (аналогично Backspace).
• Ctrl+ i : эквивалент клавиши табуляции.
• Ctrl+ j : Эквивалент клавиши ввода.
• Ctrl+ k : Очищает содержимое строки после курсора и копирует его в буфер обмена .
• Ctrl+ l : Очищает содержимое экрана (эквивалентно команде clear).
• Ctrl+ n : ( next ) вызывает следующую команду (эквивалент клавиши ↓).
• Ctrl+ o : выполняет найденную команду из истории и извлекает следующую строку относительно текущей строки из истории для редактирования.
• Ctrl+ p : ( предыдущая ) вызывает предыдущую команду (эквивалент клавиши ↑).
• Ctrl+ r : (обратный поиск) вызывает последнюю команду, включая указанные символы. Второй Ctrl+ r вызывает следующую переднюю команду, соответствующую поиску
• Ctrl+ s : вернуться к следующей, более поздней команде обратного поиска (будьте осторожны, не выполняйте ее с терминала, поскольку эта команда также запускает XOFF). Если вы изменили настройку XOFF, используйте Ctrl+ q вернуться.
• Ctrl+ t : транспонировать два предыдущих символа.
• Ctrl+ u : Очищает содержимое строки перед курсором и копирует его в буфер обмена .
• Ctrl+ v : Если следующий ввод также является управляющей последовательностью, введите его буквально (например, * Ctrl+ v Ctrl+ h введите «^H», буквальный пробел.)
• Ctrl+ w : Очищает слово перед курсором и копирует его в буфер обмена .
• Ctrl+ x Ctrl+ e : Редактирует текущую строку в программе $EDITOR или vi , если она не определена.
• Ctrl+ x Ctrl+ r : прочитать содержимое файла inputrc и включить все найденные там привязки или назначения переменных.
• Ctrl+ x Ctrl+ u : Поэтапная отмена, запоминается отдельно для каждой строки.
• Ctrl+ x Ctrl+ v : Отобразить информацию о версии текущего экземпляра Bash.
• Ctrl+ x Ctrl+ x : чередует курсор с его старой позицией. (Cx, потому что x имеет форму пересечения).
• Ctrl+ y : ( yank ) добавляет содержимое буфера обмена из позиции курсора.
• Ctrl+ z : отправляет сигнал SIGTSTP текущей задаче, которая приостанавливает ее. Чтобы выполнить его в фоновом режиме, можно ввести bg. Чтобы вернуть его из фона или приостановки fg ['process name or job id'] ( передний план ) может быть выдан.
• Ctrl+ _ : Поэтапная отмена, запоминается отдельно для каждой строки.
• Alt+ b : ( назад ) перемещает курсор на одно слово назад.
• Alt+ c : делает символ под курсором заглавным и перемещает его в конец слова.
• Alt+ d : вырезает слово после курсора.
• Alt+ f : ( вперед ) перемещает курсор на одно слово вперед.
• Alt+ l : понижает регистр каждого символа от позиции курсора до конца текущего слова.
• Alt+ r : Отменяет изменения и возвращает строку в том виде, в каком она была в истории.
• Alt+ u : переводит с заглавной буквы каждый символ от позиции курсора до конца текущего слова.
• Alt+ . : вставить последний аргумент предыдущей команды (последнее слово предыдущей записи истории).

GPL в качестве лицензии

GNU Readline примечателен тем, что является библиотекой свободного программного обеспечения , лицензируемой по лицензии GNU General Public License (GPL). Библиотеки свободного программного обеспечения гораздо чаще лицензируются по лицензии GNU Lesser General Public License (LGPL), например, библиотека GNU C , GNU gettext и FLTK . Разработчик приложения, выбравший ссылку на библиотеку с лицензией LGPL, может использовать для приложения любую лицензию. Но для подключения к библиотеке, лицензируемой GPL, такой как Readline, требуется, чтобы все объединенное полученное приложение при распространении было лицензировано по GPL, чтобы соответствовать разделу 5 GPL.

Это лицензирование было выбрано FSF в надежде, что оно побудит программное обеспечение перейти на GPL. Важным примером изменения лицензии приложения для соответствия условиям авторского лева GNU Readline является CLISP , реализация Common Lisp . Первоначально выпущенная в 1987 году, она была изменена на лицензию GPL в 1992 году. после обмена электронными письмами между одним из первоначальных авторов CLISP, Бруно Хейбле, и Ричардом Столлманом , в котором Столлман утверждал что связывание readline с CLISP означало, что Haible должен был повторно лицензировать CLISP под лицензией GPL, если он хотел распространять реализацию CLISP, в которой использовалась readline.

Другой ответ заключался в том, чтобы не использовать это в некоторых проектах, заставляя при вводе текста использовать для редактирования примитивный драйвер терминала Unix.

Альтернативные библиотеки

Альтернативные библиотеки были созданы с другими лицензиями, поэтому их можно использовать в программных проектах, которые хотят реализовать функции редактирования командной строки, но выпускаются с лицензией, отличной от GPL.

• Многие системы BSD имеют лицензию libedit . MariaDB и PHP позволяют пользователю выбирать во время сборки, связываться ли с GNU Readline или с libedit.
• linenoise — это крошечная библиотека C, предоставляющая функции редактирования строк.
• Haskeline — это лицензированная BSD-3-Clause библиотека, подобная readline, для Haskell. В основном он написан для компилятора Glasgow Haskell , но доступен для других проектов Haskell, которым также необходимы услуги по редактированию строк.
• PSReadLine — это реализация строки чтения под лицензией BSD-2-Clause, написанная на C# для PowerShell, вдохновленная bash и GNU Readline.

Пример кода

Следующий код написан на языке C и должен быть связан с библиотекой readline путем передачи -lreadline флаг компилятору:

#include <stdlib.h>
#include <stdio.h>
#include <readline/readline.h>
#include <readline/history.h>

int main()
{
    // Configure readline to auto-complete paths when the tab key is hit.
    rl_bind_key('\t', rl_complete);

    // Enable history
    using_history();

    while (1) {
        // Display prompt and read input
        char* input = readline("prompt> ");

        // Check for EOF.
        if (!input)
            break;

        // Add input to readline history.
        add_history(input);

        // Do stuff...

        // Free buffer that was allocated by readline
        free(input);
    }
    return 0;
}

Привязки

Языки программирования, отличные от C, которые обеспечивают привязку языка для readline, включают в себя

• встроенный в Python readline модуль;
• встроенный в Ruby readline модуль;
• Сторонняя программа Perl (CPAN) Term::ReadLine модуль, в частности Term::ReadLine::Gnu для GNU ReadLine.

Поддержка альтернатив readline различается в зависимости от этих привязок.

Внешние ссылки

• Вещи, которые вы не знали о GNU Readline