ritka-admin / sd_cli

Состав команды:

• Ильнур Галиев
• Маргарита Лазарева
• Ильсияр Фаттахова

Язык реализации - Python.

Запуск

python3 -m src

I этап. Реализация команд cat, echo, wc, pwd, exit

Подходы к решению

(1)

• Чтение сырой строки
• Разбиение строки на объекты в одинарных кавычках и все остальные (задача лексера)
• Парсинг строки и создание объекта под соответствующую команду или обработка исключения (при некорректной команде)
• Вывод результата
• Последующее чтение команд до терминирующего условия (exit, и т.д.)

Пример обработки одной команды:

Описание основных сущностей:

Лексер - сущность для разбиения на токены в зависимости от кавычек. Двойные кавычки необходимо интерпретировать, одинарные - воспринимать как строковые литералы. Результат работы лексера - список объектов PlainString и InterpretString.

Классы PlainString, InterpretString - классы для литеральных и исполняемых (команды, подставляемые переменные) соответственно. Используются для определения типа объекта.

Парсер - чтение списка исполняемых объектов, рассмотрение case'ов (if... elif...else...), создание объекта в зависимости от полученной команды, бросание Exception'a в случае получения невалидной (нереализованной) команды (вывод, что текущая программа завершилась с ненулевым кодом ошибки). Различает команды, операции присваивания переменных и невалидные команды (всё остальное).

Глобальное хранилище (словарь) переменных окружения Context - добавить все имеющиеся в системе переменные + занесение новых вводимых переменных. (Как будем добавлять изначальный пулл env'ов?)

Класс Command - общий интерфейс для всех реализуемых команд, содержит функции substitute_vars, execute. Стандартная реализация substite_vars - проверка наличия переменной окружения в глобальном хранилище (context) и её подстановка, если объект является InterpretString. Стандартная реализация execute - os.system(raw_cmd) (?)

Классы CatCommand, EchoCommand, WcCommand... - реализации интерфейса Command под каждую команду.

Класс VarAssigmentCommand - также реализация класса Command, у которой метод execute определён как добавление новой переменной в глобальное хранилище Context.

Подводные камни

• Работа с кавычками
  • обработка вложенных кавычек
  • разбиение на литеральные/не литеральные строки (одинарные/двойные кавычки соответственно)
• установка переменной окружения
  • игнорирование/включение пробелов справа от присваивания когда нет кавычек
  • подставлять только один раз (исключить рекурсивную подстановку)
• интерпретация спецсимволов ($, и т.д.)
• терминирующие условия (только exit, исключения обрабатываем?)
• обработка строк, записанных подряд без пробелов ("ex""it")

II этап. Реализация конвейерной обработки команд (pipe)

Добавляется класс Pipeline

• после обработки парсером и лексером хранит объекты команд
• последовательно вызывает execute у объектов, полученных из предыдущего пункта
• записывает в строку результат выполнения предыдущей команды и передаёт её аргументом на вход следующей функции execute у соотвествующего объекта (строка будет являться необходимым вводом для команды)

Структура класса:

• поле commands со списком команд, полученных после парсинга
• метод run, забирающий выход последней команды и передающий его на вход следующей
• в случае, если в run возникает exception (в случае невалидного ввода) - прерываем весь pipeline

Подводные камни:

• exit внутри pipe (возможное решение --- прерывание пайпа)?