REFACTOR: Major improvements in Makefile from Main Template

Author: BrenoFariasdaSilva

Main Template/Makefile

@@ -3,44 +3,77 @@ VENV := venv
 OS := $(shell uname 2>/dev/null || echo Windows)
 
 # Detect correct Python and Pip commands based on OS
-ifeq ($(OS), Windows)
+ifeq ($(OS), Windows) # Windows
 	PYTHON := $(VENV)/Scripts/python.exe
 	PIP := $(VENV)/Scripts/pip.exe
 	PYTHON_CMD := python
 	CLEAR_CMD := cls
 	TIME_CMD :=
-else
+else # Unix-like
 	PYTHON := $(VENV)/bin/python3
 	PIP := $(VENV)/bin/pip
 	PYTHON_CMD := python3
 	CLEAR_CMD := clear
 	TIME_CMD := time
 endif
 
-# Main target that runs the scripts
+# Logs directory
+LOG_DIR := ./Logs
+
+# Ensure logs directory exists (cross-platform)
+ENSURE_LOG_DIR := @mkdir -p $(LOG_DIR) 2>/dev/null || $(PYTHON_CMD) -c "import os; os.makedirs('$(LOG_DIR)', exist_ok=True)"
+
+# Run-and-log function, supports DETACH variable
+# If DETACH is set, runs the script in detached mode and tails the log file
+# Else, runs the script normally
+# Run-and-log function, DETACH controls detached execution
+ifeq ($(OS), Windows) # Windows
+RUN_AND_LOG = \
+if [ -z "$(DETACH)" ]; then \
+	$(PYTHON) $(1); \
+else \
+	LOG_FILE=$(LOG_DIR)/$$(basename $(basename $(1))).log; \
+	start /B cmd /c "$(PYTHON) $(1)"; \
+	powershell -Command "Get-Content -Path '$$LOG_FILE' -Wait"; \
+fi
+else # Unix-like
+RUN_AND_LOG = \
+if [ -z "$(DETACH)" ]; then \
+	$(PYTHON) $(1); \
+else \
+	LOG_FILE=$(LOG_DIR)/$$(basename $(basename $(1))).log; \
+	nohup $(PYTHON) $(1) > $$LOG_FILE 2>&1 & \
+	tail -f $$LOG_FILE; \
+fi
+endif
+
+# Default target
 all: run
 
-# Main Scripts:
-run: $(VENV)
+# Make Rules
+run: dependencies
+	$(ENSURE_LOG_DIR)
 	$(CLEAR_CMD)
-	$(TIME_CMD) $(PYTHON) ./main.py
+	$(call RUN_AND_LOG, ./main.py)
 
-# Setup Virtual Environment and Install Dependencies
+# Create virtual environment if missing
 $(VENV):
+	@echo "Creating virtual environment..."
 	$(PYTHON_CMD) -m venv $(VENV)
-	$(PIP) install -r requirements.txt
+	$(PIP) install --upgrade pip
 
-# Install the project dependencies
 dependencies: $(VENV)
+	@echo "Installing/Updating Python dependencies..."
+	$(PIP) install -r requirements.txt
 
-# Generate requirements.txt from the current venv
+# Generate requirements.txt from current venv
 generate_requirements: $(VENV)
 	$(PIP) freeze > requirements.txt
 
-# Utility rule for cleaning the project
+# Clean artifacts
 clean:
-	rm -rf $(VENV)
+	rm -rf $(VENV) || rmdir /S /Q $(VENV) 2>nul
 	find . -type f -name '*.pyc' -delete || del /S /Q *.pyc 2>nul
 	find . -type d -name '__pycache__' -delete || rmdir /S /Q __pycache__ 2>nul
 
-.PHONY: run clean dependencies generate_requirements
+.PHONY: all run clean dependencies generate_requirements