chore: update .gitignore and Makefile for testing improvements

- Added Python-related files to .gitignore to prevent unnecessary commits.
- Updated Makefile to enhance testing commands, introducing specific targets for unit, integration, and coverage tests.
- Removed the old test runner script in favor of a more structured pytest approach.
- Created a new pyproject.toml file to manage project dependencies and configurations.
- Added comprehensive test suite structure with unit, integration, and end-to-end tests.
- Included test fixtures and utilities for better test management and organization.

Author: kzndotsh

.gitignore

@@ -45,3 +45,13 @@ webpanel_config/
 *.bak
 # WebPanel config (part of data)
 data/webpanel/config/
+
+
+# python
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+.pytest_cache/
+.ruff_cache/
+.uv_cache/

Makefile

@@ -186,19 +186,39 @@ dev-logs:
 # Testing and validation
 test:
 	@echo -e "$(PURPLE)=== Running Comprehensive Tests ===$(NC)"
-	@echo -e "$(BLUE)[INFO]$(NC) Running environment validation and functionality tests..."
-	@python3 tests/run_tests.py
+	@echo -e "$(BLUE)[INFO]$(NC) Running test suite with uv..."
+	@uv run pytest tests/
 	@echo -e "$(GREEN)[SUCCESS]$(NC) Test suite completed!"
 
 test-env:
 	@echo -e "$(PURPLE)=== Environment Validation Tests ===$(NC)"
 	@echo -e "$(BLUE)[INFO]$(NC) Validating environment setup, permissions, and configuration..."
-	@python3 tests/test_environment_validation.py --verbose
+	@uv run pytest tests/unit/test_docker_client.py -v
 
 test-irc:
 	@echo -e "$(PURPLE)=== IRC Functionality Tests ===$(NC)"
 	@echo -e "$(BLUE)[INFO]$(NC) Testing IRC server functionality..."
-	@python3 tests/test_irc_functionality.py
+	@uv run pytest tests/integration/test_docker_services.py -v
+
+test-unit:
+	@echo -e "$(PURPLE)=== Unit Tests ===$(NC)"
+	@echo -e "$(BLUE)[INFO]$(NC) Running unit tests..."
+	@uv run pytest tests/unit/ -v
+
+test-integration:
+	@echo -e "$(PURPLE)=== Integration Tests ===$(NC)"
+	@echo -e "$(BLUE)[INFO]$(NC) Running integration tests..."
+	@uv run pytest tests/integration/ -v
+
+test-cov:
+	@echo -e "$(PURPLE)=== Tests with Coverage ===$(NC)"
+	@echo -e "$(BLUE)[INFO]$(NC) Running tests with coverage report..."
+	@uv run pytest --cov=src --cov-report=html --cov-report=term-missing
+
+test-docker:
+	@echo -e "$(PURPLE)=== Docker-related Tests ===$(NC)"
+	@echo -e "$(BLUE)[INFO]$(NC) Running tests that require Docker..."
+	@uv run pytest -m docker -v
 
 test-quick:
 	@echo -e "$(PURPLE)=== Quick Environment Check ===$(NC)"

README.md

@@ -21,6 +21,7 @@ cd irc.atl.chat
 cp env.example .env
 
 # 2. Edit configuration
+# BE SURE TO READ THIS CAREFULLY AND DOUBLE CHECK ALL VARIABLES
 vim .env
 
 # 3. Setup Cloudflare DNS credentials

pyproject.toml

@@ -0,0 +1,162 @@
+[project]
+name = "irc-atl-chat"
+version = "0.1.0"
+requires-python = ">=3.11"
+description = "IRC.atl.chat - Docker-based IRC server with UnrealIRCd and Atheme"
+readme = "README.md"
+license = "MIT"
+authors = [{ name = "All Things Linux", email = "[email protected]" }]
+maintainers = [
+    { name = "All Things Linux", email = "[email protected]" },
+]
+
+
+# All dependencies (this is a testing/infrastructure project)
+dependencies = [
+    # Core infrastructure
+    "docker>=7.1.0",
+    "pyyaml>=6.0.2",
+    "requests>=2.32.5",
+    "psutil>=5.9.0",
+
+    # IRC libraries
+    "irc>=20.5.0",
+    "irc-toolkit>=0.2.0",
+    "pydle>=1.1.0",
+    "unrealircd-rpc-py>=2.0.0",
+    "websocket-client>=1.0.0",
+
+    # Testing framework
+    "pytest>=8.0.0",
+    "pytest-mock>=3.12.0",
+    "pytest-asyncio>=0.23.0",
+    "pytest-xdist>=3.0.0",
+    "pytest-html>=4.0.0",
+    "pytest-timeout>=2.4.0",
+    "pytest-sugar>=1.1.1",
+    "pytest-docker>=3.0.0",
+
+    # Code quality
+    "ruff>=0.6.0",
+    "basedpyright>=0.6.0",
+    "pre-commit>=3.0.0",
+]
+
+[project.urls]
+repository = "https://github.com/allthingslinux/irc.atl.chat"
+homepage = "https://irc.atl.chat"
+
+[tool.pytest.ini_options]
+# Test discovery
+testpaths = ["tests"]
+python_files = ["test_*.py", "*_test.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+
+# Default options for all pytest runs
+addopts = [
+    # Output formatting
+    "--strict-markers",
+    "--tb=short",
+    # Verbose logging
+    "-v",
+    "--color=yes",
+    "--durations=10",
+    # Async support
+    "--asyncio-mode=auto",
+]
+
+# Markers
+markers = [
+    "slow: marks tests as slow (deselect with '-m \"not slow\"')",
+    "integration: marks tests as integration tests",
+    "unit: marks tests as unit tests",
+    "docker: marks tests that require Docker",
+    "irc: marks tests that require IRC server",
+    "network: marks tests that require network access",
+    "e2e: marks tests as end-to-end tests",
+    "atheme: marks tests that require Atheme services",
+    "webpanel: marks tests that require WebPanel",
+    "ssl: marks tests that require SSL functionality",
+    "performance: marks tests as performance tests",
+    "async: marks tests as async tests",
+    "protocol: marks tests for IRC protocol compliance",
+    "unrealircd: marks tests specific to UnrealIRCd",
+    "ircv3: marks tests for IRCv3 features",
+]
+
+# Filter warnings
+filterwarnings = ["error", "ignore::UserWarning", "ignore::DeprecationWarning"]
+
+# Minimum version
+minversion = "8.0"
+
+# Test timeout (in seconds)
+timeout = 300
+
+# AsyncIO configuration
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "session"
+
+# Directories to skip during test discovery
+norecursedirs = [
+    ".git",
+    ".venv",
+    "venv",
+    "__pycache__",
+    ".pytest_cache",
+    "logs",
+    "data",
+]
+
+[tool.ruff]
+exclude = [".venv", "__pycache__", ".pytest_cache", "logs", "data"]
+line-length = 120
+target-version = "py311"
+
+[tool.ruff.lint]
+ignore = [
+    "E501",    # Line too long (handled by formatter)
+    "PLR0913", # Too many arguments
+    "PLR2004", # Magic value comparison
+]
+select = [
+    "E",   # pycodestyle-error
+    "F",   # pyflakes
+    "I",   # isort
+    "N",   # pep8-naming
+    "UP",  # pyupgrade
+    "B",   # flake8-bugbear
+    "SIM", # flake8-simplify
+    "PL",  # pylint
+    "RUF", # ruff
+]
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+line-ending = "lf"
+
+[tool.mypy]
+python_version = "3.11"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true
+disallow_incomplete_defs = true
+check_untyped_defs = true
+disallow_untyped_decorators = true
+no_implicit_optional = true
+warn_redundant_casts = true
+warn_unused_ignores = true
+warn_no_return = true
+warn_unreachable = true
+strict_equality = true
+show_error_codes = true
+
+[tool.uv]
+# uv-specific configuration
+cache-dir = ".uv_cache"
+
+[[tool.mypy.overrides]]
+module = ["docker.*", "irc.*", "pydle.*", "unrealircd_rpc_py.*"]
+ignore_missing_imports = true

tests/README.md

@@ -0,0 +1,63 @@
+# IRC.atl.chat Test Suite
+
+This directory contains the comprehensive test suite for IRC.atl.chat using pytest and uv.
+
+## Structure
+
+- `unit/` - Unit tests for individual components
+- `integration/` - Integration tests for component interactions
+- `e2e/` - End-to-end tests for complete workflows
+- `utils/` - Test utilities and helper functions
+- `fixtures/` - Test fixtures and sample data
+- `conftest.py` - Shared pytest fixtures and configuration
+
+## Running Tests
+
+### Using Make (Recommended)
+```bash
+make test              # Run all tests
+make test-unit         # Run unit tests only
+make test-integration  # Run integration tests only
+make test-cov          # Run tests with coverage
+make test-docker       # Run Docker-related tests
+```
+
+### Using uv directly
+```bash
+uv run pytest tests/                    # Run all tests
+uv run pytest tests/unit/              # Run unit tests
+uv run pytest tests/integration/       # Run integration tests
+uv run pytest --cov=src               # Run with coverage
+uv run pytest -m docker               # Run Docker tests
+uv run pytest -m slow                 # Run slow tests
+```
+
+## Test Markers
+
+- `@pytest.mark.unit` - Unit tests
+- `@pytest.mark.integration` - Integration tests
+- `@pytest.mark.docker` - Tests requiring Docker
+- `@pytest.mark.irc` - Tests requiring IRC server
+- `@pytest.mark.slow` - Slow-running tests
+- `@pytest.mark.network` - Tests requiring network access
+
+## Configuration
+
+Tests are configured via:
+- `pyproject.toml` - pytest configuration and dependencies
+- `pytest.ini` - Additional pytest settings
+- `.coveragerc` - Coverage configuration
+
+## Fixtures
+
+Common fixtures available:
+- `docker_client` - Docker API client
+- `project_root` - Project root directory
+- `compose_file` - Docker Compose file path
+- `irc_helper` - IRC connection helper
+- `docker_compose_helper` - Docker Compose operations
+- `sample_config_data` - Sample configuration data
+
+## Dependencies
+
+Test dependencies are managed via uv and defined in `pyproject.toml` under `[project.optional-dependencies] test`.

tests/__init__.py

@@ -0,0 +1,3 @@
+"""IRC.atl.chat test suite."""
+
+__version__ = "0.1.0"