Merge pull request #213 from AlexandrAnatoliev/fix-issue-53

Fix issue 53

Author: B3rou

Playground/AlexandrAnatoliev/CookingMeasurementConverter-Java-AlexandrAnatoliev/README.md

@@ -0,0 +1,92 @@
+# Cooking Measurement Converter 
+Simple utility to convert between common cooking measurements.
+
+> **Author:** Alexandr Anatoliev
+
+> **GitHub:** [AlexandrAnatoliev](https://github.com/AlexandrAnatoliev)
+
+---
+
+## Features 
+* Supports common cooking measures: 
+  - Milliliters -> ml
+  - Cups -> cup
+  - Tablespoons -> tbsp
+  - Teaspoons -> tsp
+* Enchanced console output with ANSI colors
+* Provides clear error messages for invalid input
+
+---
+
+## Project structure 
+
+```
+CookingMeasurementConverter/
+├── README.md
+└── src
+   ├── Colors.java
+   ├── Converter.java
+   └── Measures.java
+```
+
+---
+
+## Compilation
+To compile the source classes:
+```
+javac -d bin src/*.java
+```
+
+---
+
+## Usage
+
+* Navigate to `bin/` directory
+```
+cd bin/
+```
+* Run program
+```
+java Converter <arguments>
+```
+* Run from root directory
+```
+java -cp bin Converter <arguments>
+```
+* Input format:
+  - [value]       The quantity to convert      
+  - [from units]  Source measurement unit (ml, cup, tbsp, tsp)      
+  - [to units]    Target measurement unit (ml, cup, tbsp, tsp)     
+``` 
+[value] [from units] [to units]
+``` 
+
+---
+
+## Examples of use
+```
+java -cp bin/ Converter 1 cup tbsp
+1 cup = 16 tbsp
+```
+
+```
+java -cp bin/ Converter invalid input arguments
+
+ERROR: For input string: "invalid"
+
+Input format:
+Converter [value] [from units] [to units]
+Units:
+Milliliters -> ml
+Cups -> cup
+Tablespoons -> tbsp
+Teaspoons -> tsp
+Example use:
+java -cp bin/ Converter 1 cup tbsp
+```
+
+---
+
+## Requirements
+* Java 8 or higher
+* Terminal/console that supports ANSI colors codes

Playground/AlexandrAnatoliev/CookingMeasurementConverter-Java-AlexandrAnatoliev/src/Colors.java

@@ -0,0 +1,35 @@
+/**
+* Enum representation supported ANSI color codes for console output.
+*
+* @version  0.1.0
+* @since    2.12.2025
+* @author   AlexandrAnatoliev
+*/
+ public enum Colors {
+    RED("\u001B[31m"),
+    GREEN("\u001B[32m"),
+    YELLOW("\u001B[33m"),
+    /** Reset ANSI color code */
+    RESET("\u001B[0m");
+
+    private final String code;
+
+    Colors(String code) {
+        this.code = code;
+    }
+
+    @Override
+    public String toString() {
+        return code;
+    }
+
+    /** 
+    * Convenience method to colorize text
+    * 
+    * @param text The text to colorize
+    * @return The colorized string 
+    */
+    public String apply(String text) {
+        return this + text + RESET;
+    }
+ }

Playground/AlexandrAnatoliev/CookingMeasurementConverter-Java-AlexandrAnatoliev/src/Converter.java

@@ -0,0 +1,95 @@
+/**
+* Cooking Measurement Converter 
+* 
+* Simple utility to convert between common cooking measurements
+*
+* USAGE:
+* Input format:
+*   [value] [from units] [to units]
+* Units:
+*   Milliliters -> ml
+*   Cups -> cup
+*   Tablespoons -> tbsp
+*   Teaspoons -> tsp
+* Example use:
+*   java -cp bin/ Converter 1 cup tbsp
+*
+* @version  0.1.0
+* @since    2.12.2025
+* @author   AlexandrAnatoliev
+*/
+public class Converter {
+    /** Main entry point for the Converter application
+    *
+    * @param args command line arguments 
+    *   [value]         Value of user's product     
+    *   [from units]    Units need to convert from     
+    *   [to units]      Units need to convert to     
+    */
+    public static void main(String[] args) {
+        if (args.length > 2) {
+            try {
+                int value = Integer.parseInt(args[0]);
+                Measures from = parse(args[1]);
+                Measures to = parse(args[2]);
+
+                if (from == Measures.ERROR || to == Measures.ERROR) {
+                    printExample();
+                }
+                else {
+                    System.out.println(value + " " + args[1] + " = "
+                            + convert(value, from, to) + " " + args[2]);
+                }
+            } catch (IllegalArgumentException e) {
+                System.out.println(Colors.RED.apply("\nERROR: " + e.getMessage()));
+                printExample();
+            }
+        } 
+        else {
+            printExample();
+        }
+    }
+
+    /**
+    * Converts value from one units to other units
+    *
+    * @param value  Value of user's product
+    * @param from   Units need to convert from
+    * @param to     Units need to convert to
+    * @return int   Result of converting 
+    */
+    public static int convert(int value, Measures from, Measures to) {
+        return value * from.inMl / to.inMl;
+    }
+
+    /**
+    * Parses input string to Measures value
+    *
+    * @param input  Measure in string
+    * @throws IllegalArgumentException If input is illegal argument
+    * @return int   Result of parsing 
+    */
+    public static Measures parse(String input) {
+        try {
+            return Measures.valueOf(input.toUpperCase());
+        } catch (IllegalArgumentException e) {
+            System.out.println(Colors.RED.apply("ERROR: " + e.getMessage()));
+            return Measures.ERROR;
+        }
+    }
+
+    /**
+    * Prints usage instructions
+    */
+    public static void printExample() {
+        System.out.println(Colors.YELLOW.apply("\nInput format:"));
+        System.out.println("Converter [value] [from units] [to units]");
+        System.out.println(Colors.YELLOW.apply("Units:"));
+        System.out.println("Milliliters -> ml");
+        System.out.println("Cups -> cup");
+        System.out.println("Tablespoons -> tbsp");
+        System.out.println("Teaspoons -> tsp");
+        System.out.println(Colors.YELLOW.apply("Example use:"));
+        System.out.println("java -cp bin/ Converter 1 cup tbsp");
+    }
+}

Playground/AlexandrAnatoliev/CookingMeasurementConverter-Java-AlexandrAnatoliev/src/Measures.java

@@ -0,0 +1,20 @@
+/**
+* Enum representation of common cooking measures with conversation to milliliters.
+*
+* @version  0.1.0
+* @since    2.12.2025
+* @author   AlexandrAnatoliev
+*/
+public enum Measures {
+    ML(1),
+    CUP(250),
+    TBSP(15),
+    TSP(5),
+    ERROR(-1);
+
+    public final int inMl;
+
+    Measures(int inMl) {
+        this.inMl = inMl;
+    }
+ }