HW01. CLI. Громов Павел

.gitignore

@@ -52,8 +52,10 @@ buildNumber.properties
 ## Gradle
 ##############################
 bin/
-build/
-.gradle
+*build/
+*gradle
+*gradlew*
+*.gradle
 .gradletasknamecache
 gradle-app.setting
 !gradle-wrapper.jar

Readme.md

@@ -0,0 +1,26 @@
+# CLI
+
+Данный проект - это интерпретатор командной строки, поддерживающий следующие команды:
+- `cat [FILE]` - вывести на экран содержимое файла;
+- `echo` - вывести на экран свой аргумент (или аргументы);
+- `wc [FILE]` - вывести количество строк, слов и байт в файле;
+- `pwd` - распечатать текущую директорию;
+- `exit` - выйти из интерпретатора.
+
+Интерпретатор распознает строку при помощи парсера, который разделяет текст на 
+лексемы ([`Lexemes`](https://github.com/PaGr0m/ifmo-software-design/blob/master/shell/src/main/java/parser/LexemType.java)), 
+которые поддерживают одинарные и двойные кавычки, а также оператор подстановки переменных окружения (`$`).
+
+Все остальные команды, которые не перечислены в задании ("внешние команды") вызываются из Shell системы.
+
+У `CLI` имеется свое окружение ([`Environment`](https://github.com/PaGr0m/ifmo-software-design/blob/master/shell/src/main/java/service/Environment.java)),
+которое хранит в себе все переменные окружения, а также доступные команды. 
+Окружение является единственным для всего проекта. 
+Было принято решение избавиться от шаблона одиночки ([`Singleton`](https://refactoring.guru/ru/design-patterns/singleton)) 
+для него, а использовать внедрение зависимостей ([`Dependency Injection`](https://en.wikipedia.org/wiki/Dependency_injection#:~:text=In%20software%20engineering%2C%20dependency%20injection,object%20is%20called%20a%20service.)).
+
+Для имплементации команд CLI было решено использовать паттерн "Команда" ([`Command`](https://refactoring.guru/ru/design-patterns/command)), 
+так как очень удобно задать единый интерфейс для функционала команды и реализовать метод для каждой команды. 
+Для создания команд отказался от использования шаблона "Фабрика" ([`Factory Method`](https://refactoring.guru/ru/design-patterns/factory-method)), 
+так как в данном случае посчитал это излишнем, поскольку обращение в `HashMap` будет намного быстрее и 
+по названию команды можно выдавать объект (в данном случае масштабируемость шаблона "Фабрика" никак не использовалась бы).

shell/build.gradle

@@ -0,0 +1,29 @@
+plugins {
+    id 'java'
+}
+
+group 'org.jetbrains'
+version '1.0-SNAPSHOT'
+
+sourceCompatibility = 1.8
+
+repositories {
+    mavenCentral()
+    jcenter()
+}
+
+dependencies {
+    implementation 'org.jetbrains:annotations:15.0'
+
+    compile group: 'org.apache.logging.log4j', name: 'log4j-api', version: '2.13.0'
+    compile group: 'org.apache.logging.log4j', name: 'log4j-core', version: '2.13.0'
+
+    compileOnly 'org.projectlombok:lombok:1.18.12'
+    annotationProcessor 'org.projectlombok:lombok:1.18.12'
+
+    testCompileOnly 'org.projectlombok:lombok:1.18.12'
+    testCompile group: 'junit', name: 'junit', version: '4.12'
+    testCompile "org.mockito:mockito-core:2.+"
+    testCompile "org.assertj:assertj-core:3.11.1"
+    testAnnotationProcessor 'org.projectlombok:lombok:1.18.12'
+}

shell/local.properties

@@ -0,0 +1,8 @@
+## This file must *NOT* be checked into Version Control Systems,
+# as it contains information specific to your local configuration.
+#
+# Location of the SDK. This is only used by Gradle.
+# For customization when using a Version Control System, please read the
+# header note.
+#Mon Mar 02 23:59:06 MSK 2020
+sdk.dir=/home/pagrom/Android/Sdk

shell/settings.gradle

@@ -0,0 +1,2 @@
+rootProject.name = 'shell'
+

shell/shell.iml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module external.root.project.path="$MODULE_DIR$" external.system.id="GRADLE" type="JAVA_MODULE" version="4" />

shell/src/main/java/Application.java

@@ -1,8 +1,10 @@
 import service.Shell;
 
+/**
+ * Shell application
+ */
 public class Application {
-
     public static void main(String[] args) {
-        new Shell().run();
+        Shell.run();
     }
 }

shell/src/main/java/commands/Command.java

@@ -1,9 +1,20 @@
 package commands;
 
-public interface Command {
-    String name();
+import org.jetbrains.annotations.NotNull;
+
+import java.util.List;
+import java.util.stream.Collectors;
 
-    String run(String arguments, String options);
+/**
+ * Интерфейс для команды
+ */
+public interface Command {
+    String run(List<String> arguments);
 
-    void setName(String name);
+    default String joinArguments(@NotNull List<String> arguments) {
+        return arguments.stream()
+                        .filter(str -> !str.equals(""))
+                        .map(String::trim)
+                        .collect(Collectors.joining(" "));
+    }
 }