Merge branch 'dev'

This commit is contained in:
KamaSK 2025-05-29 22:21:44 +03:00
commit 75bc8977b1
12 changed files with 364 additions and 1 deletions

14
todo/CHANGELOG.md Normal file
View File

@ -0,0 +1,14 @@
# Журнал изменений
Все заметные изменения проекта будут документироваться в этом файле.
Формат основан на [Keep a Changelog](https://keepachangelog.com/ru/1.0.0/),
и этот проект придерживается [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
## [2.0.0] - 2025-05-29
### Добавлено
- Базовая функциональность для управления задачами
- Команды: create, list, delete
- Консольный интерфейс для взаимодействия с приложением
- In-memory хранилище задач

27
todo/README.md Normal file
View File

@ -0,0 +1,27 @@
# TodoApp
## Описание
TodoApp - это консольное приложение для управления списком задач, разработанное на Java в качестве учебного проекта. Приложение позволяет создавать, просматривать, отмечать как выполненные и удалять задачи через интерфейс командной строки.
## Требования
- Java 24 или выше
- Maven 3.8.x или выше
### Доступные команды
- `create <названиеадачи>` - Создать новую задачу
- `list` - Показать список всех задач
- `complete <id>` - Отметить задачу как выполненную
- `delete <id>` - Удалить задачу
- `exit` - Выйти из приложения
## Структура проекта
- `model` - Модели данных (Task, SimpleTask)
- `repo` - Репозитории для хранения задач
- `service` - Бизнес-логика
- `cli` - Компоненты интерфейса командной строки
## Версии
Актуальная версия: 2.0
## Лицензия
[MIT](LICENSE)

View File

@ -6,7 +6,7 @@
<groupId>ru.kamask.pet</groupId>
<artifactId>todo</artifactId>
<version>1.0-SNAPSHOT</version>
<version>2.0-SNAPSHOT</version>
<properties>
<maven.compiler.release>24</maven.compiler.release>

View File

@ -0,0 +1,69 @@
package ru.kamask.pet.todo.cli;
import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
import java.util.Arrays;
import java.util.HashMap;
import java.util.Optional;
import ru.kamask.pet.todo.service.TaskService;
public class CliEngine {
private HashMap<String, Command> registry = new HashMap<>();
private TaskService service;
private BufferedReader reader;
public CliEngine(TaskService service) {
this.service = service;
reader = new BufferedReader(new InputStreamReader(System.in));
initializeCommands();
}
public void start() throws IOException {
System.out.println("\обро пожаловать в Список задач 2.0!");
System.out.println("Введите help для просмтора доступных команд или exit для выхода.");
while (true) {
System.out.print("\ntodo> ");
var input = reader.readLine().trim();
System.out.println();
switch (input) {
case "help" -> handleHelp();
case "exit" -> System.exit(0);
default -> handleCommand(input).ifPresentOrElse(System.out::println, () -> {
System.out.println("Не известная команда. Повторите ввод.\n");
handleHelp();
});
}
}
}
void registerCommand(Command command) {
registry.put(command.name(), command);
}
void initializeCommands() {
registerCommand(new CreateCommand());
registerCommand(new ListCommand());
registerCommand(new CompleteCommand());
registerCommand(new DeleteCommand());
}
void handleHelp() {
registry.values().stream().map(handler -> handler.usage()).forEach(System.out::println);
System.out.printf(Command.templateUsage, "help", "Вот этот список команд\n");
System.out.printf(Command.templateUsage, "exit", "Выход, но лучше не надо)\n");
}
Optional<String> handleCommand(String input) {
var parts = input.split("\\s+");
var command = parts[0];
var args = Arrays.copyOfRange(parts, 1, parts.length);
var handlerOpt = Optional.ofNullable(registry.get(command));
if (handlerOpt.isPresent())
return handlerOpt.get().handle(args, service);
return Optional.empty();
}
}

View File

@ -0,0 +1,16 @@
package ru.kamask.pet.todo.cli;
import java.util.Optional;
import ru.kamask.pet.todo.service.TaskService;
public interface Command {
String templateUsage = " %-30s // %s";
String errorMessage = "Не корректно введена команда. Введите help для спарвки.";
Optional<String> handle(String[] args, TaskService service);
String name();
String usage();
}

View File

@ -0,0 +1,34 @@
package ru.kamask.pet.todo.cli;
import java.util.Optional;
import ru.kamask.pet.todo.service.TaskService;
public class CompleteCommand implements Command {
@Override
public String name() {
return "complete";
}
@Override
public String usage() {
return String.format(Command.templateUsage, name() + " <ID>", "Отметить задачу как \"выполнена\".");
}
@Override
public Optional<String> handle(String[] args, TaskService service) {
if (args.length != 1)
return Optional.of(Command.errorMessage);
try {
int id = Integer.parseInt(args[0]);
return Optional.of(service.complete(id)
? "Задача ID-%d выполнена.".formatted(id)
: "Задача ID-%d не найдена.".formatted(id));
} catch (NumberFormatException e) {
return Optional.of("ID - должен быть числом.");
}
}
}

View File

@ -0,0 +1,29 @@
package ru.kamask.pet.todo.cli;
import java.util.Optional;
import ru.kamask.pet.todo.service.TaskService;
public class CreateCommand implements Command {
@Override
public String name() {
return "create";
}
@Override
public Optional<String> handle(String[] args, TaskService service) {
if (args.length > 0) {
var title = String.join(" ", args);
if (title.length() > 30)
return Optional.of("Ошибка: максимальная длинна названия задачи 30 символов.");
service.create(title);
return Optional.of(String.format("Задача \"%s\" успешно добавлена!", title));
}
return Optional.of(Command.errorMessage);
}
@Override
public String usage() {
return String.format(templateUsage, name() + "азваниеадачи>", "Добавление новой задачи");
}
}

View File

@ -0,0 +1,35 @@
package ru.kamask.pet.todo.cli;
import java.util.Optional;
import ru.kamask.pet.todo.service.TaskService;
public class DeleteCommand implements Command {
@Override
public String name() {
return "delete";
}
@Override
public String usage() {
return String.format(Command.templateUsage, name() + " <ID>", "Удалить задачу.");
}
@Override
public Optional<String> handle(String[] args, TaskService service) {
if (args.length != 1)
return Optional.of(Command.errorMessage);
try {
int id = Integer.parseInt(args[0]);
if (!service.has(id))
return Optional.of("Задача ID-%d не найдена.".formatted(id));
service.remove(id);
return Optional.of("Задача ID-%d удалена.".formatted(id));
} catch (NumberFormatException e) {
return Optional.of("ID - должен быть числом.");
}
}
}

View File

@ -0,0 +1,39 @@
package ru.kamask.pet.todo.cli;
import java.util.Optional;
import ru.kamask.pet.todo.model.SimpleTask;
import ru.kamask.pet.todo.model.Task;
import ru.kamask.pet.todo.service.TaskService;
public class ListCommand implements Command {
@Override
public String name() {
return "list";
}
@Override
public Optional<String> handle(String[] args, TaskService service) {
if (args.length > 0)
return Optional.of(Command.errorMessage);
String template = "%-2s | %-30s | %s\n";
String res = "";
res += String.format(template, "ID", "Название задачи", "Статус");
res += "-".repeat(50) + "\n";
if (service.list().size() == 0)
return Optional.of(res + "\nСписок задач пуст.");
for (Task task : service.list()) {
SimpleTask.Data data = ((SimpleTask) task).data();
res += String.format(template, data.id(), data.title(), data.done() ? "выполнено" : "не выполнено");
}
return Optional.of(res);
}
@Override
public String usage() {
return String.format(templateUsage, name(), "Список всех задач.");
}
}

View File

@ -0,0 +1,37 @@
package ru.kamask.pet.todo.repo;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import java.util.Optional;
import ru.kamask.pet.todo.model.Task;
public class InMemoryTaskRepository implements TaskRepository {
private Map<Integer, Task> storage = new HashMap<>();
@Override
public void save(Task task) {
storage.put(task.id(), task);
}
@Override
public Optional<Task> findById(int id) {
return Optional.ofNullable(storage.get(id));
}
@Override
public List<Task> findAll() {
return new ArrayList<>(storage.values());
}
@Override
public void delete(int id) {
storage.remove(id);
}
public boolean has(int id) {
return storage.containsKey(id);
}
}

View File

@ -0,0 +1,18 @@
package ru.kamask.pet.todo.repo;
import java.util.List;
import java.util.Optional;
import ru.kamask.pet.todo.model.Task;
public interface TaskRepository {
void save(Task task);
Optional<Task> findById(int id);
List<Task> findAll();
void delete(int id);
boolean has(int id);
}

View File

@ -0,0 +1,45 @@
package ru.kamask.pet.todo.service;
import java.util.List;
import java.util.Optional;
import ru.kamask.pet.todo.model.Task;
import ru.kamask.pet.todo.model.SimpleTask;
import ru.kamask.pet.todo.repo.TaskRepository;
public class TaskService {
private final TaskRepository repo;
public TaskService(TaskRepository repo) {
this.repo = repo;
}
public void create(String title) {
repo.save(new SimpleTask(title));
}
public Optional<Task> getById(int id) {
return repo.findById(id);
}
public boolean complete(int id) {
var taskOpt = repo.findById(id);
if (taskOpt.isPresent()) {
taskOpt.get().markAsCompleted();
return true;
}
return false;
}
public List<Task> list() {
return repo.findAll();
}
public void remove(int id) {
repo.delete(id);
}
public boolean has(int id) {
return repo.has(id);
}
}