# nagendar-pm/cut-command-line-tool architecture

> Architecture diagram of the GitHub repository nagendar-pm/cut-command-line-tool, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nagendar-pm/cut-command-line-tool
- Repository: https://github.com/nagendar-pm/cut-command-line-tool

## Overview

##### Main Components

a) Core Processing Layer:
- CommandProcessorService (Central orchestrator)
- Command Mode Handlers (SingleCommandMode and PipedCommandMode)
- Input Command Processing Pipeline

b) Factory Layer:
- CommandExecutorFactory
- CommandValidatorFactory
- CommandModeFactory
- CommandProcessorFactory
- OptionExecutorFactory
- PrinterFactory

c) Execution Layer:
- Command Executors (CutCommandExecutor, NonCutCommandExecutor, ExitCommandExecutor)
- Option Executors (ByteCutOptionExecutor, CharacterCutOptionExecutor, FieldCutOptionExecutor)

d) Validation Layer:
- Command Validators (CutCommandValidator, NonCutCommandValidator, ExitCommandValidator)

e) I/O Layer:
- Printers (ConsolePrinter, FilePrinter)
- FileUtils

**[Input Layer]**
- ↓
**[Processing Layer]**
- ↓
**[Validation Layer]**
- ↓
**[Execution Layer]**
- ↓
**[Output Layer]**

##### Component Relationships

- Command flow from input through processing stages
- Factory dependencies and instantiation flows
- Validation and execution pipelines
- I/O operations flow

**Input Command → Command Mode Selection → Initial Processing →**
**Validation → Range Resolution → Option Processing → Execution → Output**

##### Technical Details

- Relationship between InputCommand and ProcessedCommand models
- Range processing components
- Extension points for new command types
- Error handling flow through BaseException

##### Implementation Notes

- Use UML notation for class relationships
- Interface implementations
- Factory pattern relationships
- Command pattern implementation

This design should reflect the project's strong use of the Factory pattern, Command pattern, and its pipeline-based processing approach, while clearly showing the separation between validation, execution, and I/O concerns.

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph Legend
        L1[Service]:::service
        L2[Factory]:::factory
        L3[Executor]:::executor
        L4[Validator]:::validator
        L5[I/O Component]:::io
        L6[Model/Utility]:::utility
        direction TB
    end

    subgraph "Input Layer"
        InputCommand[Input Command]:::utility
        click InputCommand "https://github.com/nagendar-pm/cut-command-line-tool/tree/main/src/main/java/com/nagendar/learning/model/"
    end

    subgraph "Core Processing Layer"
        CPS[Command Processor Service]:::service
        click CPS "https://github.com/nagendar-pm/cut-command-line-tool/blob/main/src/main/java/com/nagendar/learning/service/CommandProcessorServiceImpl.java"
        
        subgraph "Command Modes"
            SCM[Single Command Mode]:::service
            PCM[Piped Command Mode]:::service
            click SCM "https://github.com/nagendar-pm/cut-command-line-tool/tree/main/src/main/java/com/nagendar/learning/mode/"
            click PCM "https://github.com/nagendar-pm/cut-command-line-tool/tree/main/src/main/java/com/nagendar/learning/mode/"
        end

        ICM[Input Command Mapper]:::utility
        click ICM "https://github.com/nagendar-pm/cut-command-line-tool/blob/main/src/main/java/com/nagendar/learning/mapper/InputCommandToProcessedCommandMapper.java"
    end

    subgraph "Factory Layer"
        CEF[Command Executor Factory]:::factory
        CVF[Command Validator Factory]:::factory
        CMF[Command Mode Factory]:::factory
        CPF[Command Processor Factory]:::factory
        OEF[Option Executor Factory]:::factory
        PF[Printer Factory]:::factory
        click CEF "https://github.com/nagendar-pm/cut-command-line-tool/blob/main/src/main/java/com/nagendar/learning/factory/CommandExecutorFactory.java"
        click CVF "https://github.com/nagendar-pm/cut-command-line-tool/blob/main/src/main/java/com/nagendar/learning/factory/CommandValidatorFactory.java"
        click CMF "https://github.com/nagendar-pm/cut-command-line-tool/blob/main/src/main/java/com/nagendar/learning/factory/CommandModeFactory.java"
        click CPF "https://github.com/nagendar-pm/cut-command-line-tool/blob/main/src/main/java/com/nagendar/learning/factory/CommandProcessorFactory.java"
        click OEF "https://github.com/nagendar-pm/cut-command-line-tool/blob/main/src/main/java/com/nagendar/learning/factory/OptionExecutorFactory.java"
        click PF "https://github.com/nagendar-pm/cut-command-line-tool/blob/main/src/main/java/com/nagendar/learning/factory/PrinterFactory.java"
    end

    subgraph "Validation Layer"
        CCV[Cut Command Validator]:::validator
        NCV[Non-Cut Command Validator]:::validator
        ECV[Exit Command Validator]:::validator
        click CCV "https://github.com/nagendar-pm/cut-command-line-tool/tree/main/src/main/java/com/nagendar/learning/validator/"
        click NCV "https://github.com/nagendar-pm/cut-command-line-tool/tree/main/src/main/java/com/nagendar/learning/validator/"
        click ECV "https://github.com/nagendar-pm/cut-command-line-tool/tree/main/src/main/java/com/nagendar/learning/validator/"
    end

    subgraph "Execution Layer"
        CCE[Cut Command Executor]:::executor
        NCE[Non-Cut Command Executor]:::executor
        ECE[Exit Command Executor]:::executor
        
        subgraph "Option Executors"
            BCE[Byte Cut Option]:::executor
            CCE2[Char Cut Option]:::executor
            FCE[Field Cut Option]:::executor
        end
        click CCE "https://github.com/nagendar-pm/cut-command-line-tool/tree/main/src/main/java/com/nagendar/learning/executor/"
        click NCE "https://github.com/nagendar-pm/cut-command-line-tool/tree/main/src/main/java/com/nagendar/learning/executor/"
        click ECE "https://github.com/nagendar-pm/cut-command-line-tool/tree/main/src/main/java/com/nagendar/learning/executor/"
        click BCE "https://github.com/nagendar-pm/cut-command-line-tool/tree/main/src/main/java/com/nagendar/learning/option/"
        click CCE2 "https://github.com/nagendar-pm/cut-command-line-tool/tree/main/src/main/java/com/nagendar/learning/option/"
        click FCE "https://github.com/nagendar-pm/cut-command-line-tool/tree/main/src/main/java/com/nagendar/learning/option/"
    end

    subgraph "I/O Layer"
        CP[Console Printer]:::io
        FP[File Printer]:::io
        FU[File Utils]:::io
        click CP "https://github.com/nagendar-pm/cut-command-line-tool/tree/main/src/main/java/com/nagendar/learning/io/"
        click FP "https://github.com/nagendar-pm/cut-command-line-tool/tree/main/src/main/java/com/nagendar/learning/io/"
        click FU "https://github.com/nagendar-pm/cut-command-line-tool/blob/main/src/main/java/com/nagendar/learning/utils/FileUtils.java"
    end

    subgraph "Error Handling"
        BE[Base Exception]:::utility
        SE[Specific Exceptions]:::utility
        click BE "https://github.com/nagendar-pm/cut-command-line-tool/blob/main/src/main/java/com/nagendar/learning/exceptions/BaseException.java"
        click SE "https://github.com/nagendar-pm/cut-command-line-tool/tree/main/src/main/java/com/nagendar/learning/exceptions/"
    end

    InputCommand --> CPS
    CPS --> CMF
    CMF --> SCM & PCM
    SCM & PCM --> ICM
    ICM --> CPF
    CPF --> CEF & CVF & OEF & PF
    CEF --> CCE & NCE & ECE
    CVF --> CCV & NCV & ECV
    OEF --> BCE & CCE2 & FCE
    PF --> CP & FP
    CCE & NCE & ECE --> FU
    FU --> CP & FP

    classDef service fill:#2196F3,stroke:#1565C0,color:white
    classDef factory fill:#4CAF50,stroke:#2E7D32,color:white
    classDef executor fill:#FFC107,stroke:#FFA000,color:black
    classDef validator fill:#FF9800,stroke:#F57C00,color:white
    classDef io fill:#9C27B0,stroke:#7B1FA2,color:white
    classDef utility fill:#757575,stroke:#424242,color:white
```
