main

Author: ZmoleCristian

Makefile

@@ -0,0 +1,40 @@
+# Define the name of the executable
+EXECUTABLE=dec2ascii
+
+# Define the source files
+SRC=main.go
+
+# Define the output directory
+OUTPUT_DIR=bin
+
+# Define the installation directory
+INSTALL_DIR=/usr/local/bin
+
+# Define the compiler
+GO=go
+
+# Define the build flags
+BUILD_FLAGS=-v
+
+# Define the install flags
+INSTALL_FLAGS=
+
+# Define the clean flags
+CLEAN_FLAGS=
+
+# Build the executable
+build:
+	@echo "Building $(EXECUTABLE)..."
+	@mkdir -p $(OUTPUT_DIR)
+	@$(GO) build $(BUILD_FLAGS) -o $(OUTPUT_DIR)/$(EXECUTABLE) $(SRC)
+
+# Install the executable
+install: build
+	@echo "Installing $(EXECUTABLE)..."
+	@mkdir -p $(INSTALL_DIR)
+	@cp $(OUTPUT_DIR)/$(EXECUTABLE) $(INSTALL_DIR)/$(EXECUTABLE) $(INSTALL_FLAGS)
+
+# Clean the build artifacts
+clean:
+	@echo "Cleaning build artifacts..."
+	@rm -rf $(OUTPUT_DIR) $(CLEAN_FLAGS)

README.MD

@@ -0,0 +1,94 @@
+# 🔢 dec2ascii 🔤
+
+**dec2ascii** is a command-line tool for converting decimal numbers to ASCII text. It can read decimal numbers from the command-line arguments or from a file, and can write the output to the console or to a file. It's written in [Go](https://golang.org/) and can be compiled to run on various operating systems.  
+
+## 🚀 Getting Started
+
+### Prerequisites
+
+To compile and run **dec2ascii**, you need to have [Go](https://golang.org/) installed on your system. You can download and install Go from the official website: https://golang.org/dl/
+
+## 🐹 Installation
+
+1. Clone this repository:
+```bash
+git clone https://github.com/your-username/dec2ascii.git
+```
+2. Navigate to the project directory:
+```bash
+cd dec2ascii
+```
+
+3. Compile the source code:
+```bash
+go build -o dec2ascii main.go
+```
+
+OR 
+
+## 💾 Makefile
+
+`dec2ascii` comes with a Makefile to simplify building and installing the program. Here are the available Makefile targets:
+
+- `build` - Compiles the `dec2ascii` program.
+- `install` - Compiles and installs the `dec2ascii` program.
+- `clean` - Cleans up the build artifacts.
+
+To build and install `dec2ascii`, simply run the following command:
+```bash
+ sudo make install
+```
+
+This will compile the program and install it to the system-wide `bin` directory (`/usr/local/bin` by default).
+
+To customize the installation directory, modify the `INSTALL_DIR` variable in the Makefile.
+
+Note that the `install` target requires root privileges, as it installs the executable to the system-wide `bin` directory.
+
+
+### Usage
+```bash
+dec2ascii [-i input-file] [-o output-file] 
+dec2ascii decimal-numbers
+```
+Here's an overview of the command-line arguments:
+```bash
+-i input-file: specify an input file to read decimal numbers from
+
+-o output-file: specify an output file to write the converted text to
+
+decimal-numbers...: one or more decimal numbers to convert to ASCII text
+```
+### If the `-i` flag is not specified, the program will read decimal numbers from the command-line arguments. If the `-o` flag is not specified, the program will print the converted text to the console.
+
+<br>
+
+# 💡 Examples
+
+Here are some examples of how to use **dec2ascii**:
+
+### Convert decimal numbers from the command-line
+```bash
+dec2ascii 72 101 108 108 111 32 87 111 114 108 100
+```
+
+
+This will print the ASCII text equivalent of the decimal numbers to the console:
+```bash
+Hello World
+```
+
+
+### Convert decimal numbers from a file and write the output to a file
+
+
+This will read the decimal numbers from the `input.txt` file and write the converted text to the `output.txt` file.
+
+```bash
+dec2ascii -i input.txt -o output.txt
+```
+This will read the decimal numbers from the `input.txt` file and write the converted text to the `output.txt` file.
+
+## 📝 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

go.mod

@@ -0,0 +1,3 @@
+module dec2ascii
+
+go 1.19

main.go

@@ -0,0 +1,60 @@
+package main
+
+import (
+	"flag"     // package for command-line flag parsing
+	"fmt"      // package for console output
+	"os"       // package for interacting with the operating system
+	"strconv"  // package for string to integer conversion
+	"strings"  // package for string manipulation
+)
+
+func main() {
+	// define command-line flags
+	inputFile := flag.String("i", "", "input file")
+	outputFile := flag.String("o", "", "output file")
+	flag.Parse()
+
+	var decimalNumbers []string
+
+	if *inputFile != "" {
+		// read decimal numbers from input file
+		fileContent, err := os.ReadFile(*inputFile)
+		if err != nil {
+			// print error message to stderr and exit with non-zero status code
+			fmt.Fprintf(os.Stderr, "error reading file: %v\n", err)
+			os.Exit(1)
+		}
+		// split the file content into whitespace-separated fields (i.e., decimal numbers)
+		decimalNumbers = strings.Fields(string(fileContent))
+	} else {
+		// read decimal numbers from command-line arguments
+		decimalNumbers = flag.Args()
+	}
+
+	// convert decimal numbers to ASCII text
+	var asciiText string
+	for _, decimalStr := range decimalNumbers {
+		// convert the decimal number string to an integer
+		decimal, err := strconv.Atoi(decimalStr)
+		if err != nil {
+			// print error message to stderr and skip the invalid number
+			fmt.Fprintf(os.Stderr, "invalid decimal number: %s\n", decimalStr)
+			continue
+		}
+		// convert the decimal number to its ASCII text equivalent and append it to the output string
+		asciiText += string(decimal)
+	}
+
+	if *outputFile != "" {
+		// write the output string to the specified output file
+		err := os.WriteFile(*outputFile, []byte(asciiText), 0644)
+		if err != nil {
+			// print error message to stderr and exit with non-zero status code
+			fmt.Fprintf(os.Stderr, "error writing file: %v\n", err)
+			os.Exit(1)
+		}
+	} else {
+		// print the output string to the console
+		fmt.Println(asciiText)
+	}
+}