livace / rpn-calculator Goto Github PK

• REPL
• Перевод между записями в обе стороны (инфиксная → префиксная и наоборот)
• Сборка с помощью GraalVM native-image или jlink.
  Docker для быстро запускающейся и быстро завершающейся утилиты shell будет странным и медленным решением

ПР вмёржился, а замечания к User Stories остались там в комментариях. Дублирую:

В текущем виде, User Stories всё ещё читаются как кусочек документации готового продукта. Только теперь они похожи не на сухой раздел USAGE в man page, а на какие-нибудь "Концептуальные Концепции использования виртуальных машинок".

К чему я веду: в текущем виде истории не раскрывают потребность пользователя, а просто констатируют факт, например: "ну... если вам надо много вычислять, то у нас есть REPL". Но REPL'а ещё нет! Мы только представляем, что он наверное был бы полезен для определённого класса пользователей, и если этот класс пользователей нам действительно важен - REPL стоит реализовать.

Кроме того, у меня лично фраза "вычисления большого количества выражений подряд" вызывает ассоциации совсем не с REPL, а с batch-режимом, в котором на вход утилиты подаётся файлик со всеми выражениями, которые надо вычислить, а утилита в ответ печатает в stdout/в выходной файл результаты вычислений.

Вот бы как я переписал этот кусочек в виде требования:
"Для вычисления большого количества выражений подряд есть REPL - интерактивный режим, где можно вводить команды по одной и смотреть на результат предыдущей команды."
=>
"Как опытный пользователь CLI, я хочу выполнять вычисления в интерактивном режиме (REPL, Read-Eval-Print Loop), вводя команды по одной и просматривая результаты их выполнения на экране. REPL нужен для: одноразовых вычислений, тестирования выражений и т.д."

Шаблон юзер-стори:
"Как <тип пользователя>, я хочу <получить такие-то результаты используя продукт>, <для того чтобы ...>"
может показаться неудобным, но он реально заставляет думать в формате "чего хочет достичь с помощью продукта определённый класс пользователей и зачем". Именно поэтому шаблон так популярен - он помогает :-)

• CRC cards
• UML диаграма

• Fix Non-terminating decimal expansion
• Add infix notation
• Add files support

Совсем далекие планы

• Добавить возможность определенения функций

• Vision:
  • Прописать риски проекта
  • Подумать и указать, кто, по вашему, основные пользователи проекта. Программисты? Разработчики shell-скриптов? НЕлюбители команд bc и eval? и т.д.
• User Stories: нужно написать более общие истории. Например, "как разработчик shell-скриптов, я хочу вычислять несколько выражений сразу, чтобы ..." а не "Для вычисления нескольких выражений сразу, передайте их команде uzhos через stdin или файл, по одному в строке, разделённой \n или \n\r".

• Сборка с помощью GraalVM native-image или jlink.
  Docker для быстро запускающейся и быстро завершающейся утилиты shell будет странным и медленным решением
• Настроена система непрерывной интеграции, запускающая тесты через Maven/Gradle на каждый коммит в main и на каждый коммит в пул-реквестах. CI берите любую бесплатную и интегрирующуюся с GitHub'ом: GitHub Actions, Travis CI, …