From 7d78cc8058cdd90ba4c41d786b0b399b57d07e09 Mon Sep 17 00:00:00 2001
From: Daniel Heras Quesada <dani.heras@hotmail.com>
Date: Fri, 9 Jan 2026 00:11:37 +0100
Subject: [PATCH] feat: final details + docs

---
 image-converter/README.md                     | 21 +++++++++++++++++++
 image-converter/src/main.py                   |  8 -------
 .../src/modules/argument_parser.py            |  2 +-
 image-converter/src/modules/image_parser.py   |  5 ++---
 4 files changed, 24 insertions(+), 12 deletions(-)
 create mode 100644 image-converter/README.md

diff --git a/image-converter/README.md b/image-converter/README.md
new file mode 100644
index 0000000..935932c
--- /dev/null
+++ b/image-converter/README.md
@@ -0,0 +1,21 @@
+# Image converter
+
+Simple tool to convert images on mass.
+
+- Resize
+- Format
+
+
+## Usage
+
+- `-H <height>` : max height of vertical images.
+- `-W <width>` : max width of horizontal images.
+- `-e <extension>` : extension of the output files.
+- `-d <directory>` : input directory path.
+- `-f <file/s>` : file or list of files (paths) to parse.
+- `-o <directory>` : output directory path.
+- `-h` : print help.
+
+### Examples of usage
+
+- `python converter.py -d ./assets -f ./another/file.png ./yet\ one\ more/file2.CR2 -e png -W 1000` : convert every file inside assets plus both `file.png` and `file2.CR2` into `PNG` with a with of 1000.
diff --git a/image-converter/src/main.py b/image-converter/src/main.py
index 6b34af6..56970c6 100644
--- a/image-converter/src/main.py
+++ b/image-converter/src/main.py
@@ -1,14 +1,6 @@
 from modules.image_parser import (parse_image, parse_whole_directory)
 from modules.argument_parser import (generate_argument_parser)
 
-# NOTE: arguments
-# -H <height> : max height of vertical images
-# -W <width> : max width of horizontal images
-# -e <extension> : extension of the output files
-# -d <directory> : input directory path
-# -f <file/s> : file or list of files (paths) to parse
-# -o <directory> : output directory path
-# -h : help
 if __name__ == "__main__":
 	arg_parser = generate_argument_parser()
 	args = arg_parser.parse_args()
diff --git a/image-converter/src/modules/argument_parser.py b/image-converter/src/modules/argument_parser.py
index 565ab2e..36916c4 100644
--- a/image-converter/src/modules/argument_parser.py
+++ b/image-converter/src/modules/argument_parser.py
@@ -6,6 +6,6 @@ def generate_argument_parser():
 	parser.add_argument("-W", "--width", type=int, help="max width for horizontal images")
 	parser.add_argument("-e", "--extension", type=str, default="png",help="extension of the processed files")
 	parser.add_argument("-d", "--directory", type=str, help="directory of files to process")
-	parser.add_argument("-f", "--files", nargs="+", type=list, help="list of files to process")
+	parser.add_argument("-f", "--files", nargs="+", help="list of files to process")
 	parser.add_argument("-o", "--output", type=str, default="./",help="directory for the output files")
 	return parser
diff --git a/image-converter/src/modules/image_parser.py b/image-converter/src/modules/image_parser.py
index 088a8e6..f06a104 100644
--- a/image-converter/src/modules/image_parser.py
+++ b/image-converter/src/modules/image_parser.py
@@ -15,7 +15,7 @@ def parse_image(src: str, target_src: str, max_vertical_size_px: int, max_horizo
 			max_vertical_size_px = rawImage.height
 		target_height = max_vertical_size_px
 		target_width = math.ceil(rawImage.width * max_vertical_size_px / rawImage.height)
-	else: 
+	else:
 		if (max_horizontal_size_px == None or max_horizontal_size_px < 1):
 			max_horizontal_size_px = rawImage.width
 		target_width = max_horizontal_size_px
@@ -31,8 +31,7 @@ def parse_image(src: str, target_src: str, max_vertical_size_px: int, max_horizo
 	else:
 		target_src = os.path.abspath(target_src)
 	full_path = os.path.join(target_src, filename)
-	print(">> Path: ", full_path)
-	# rawImage.save(full_path)
+	rawImage.save(full_path)
 
 def parse_whole_directory(dir_src: str, target_src: str, max_vertical_size_px: int, max_horizontal_size_px: int, target_extension: str):
 	for file_path in get_file_path_iter(dir_src):