test: add comprehensive unit and integration test suite

- Add unit tests for SPEC file generation, checksum verification,
  dependency installation, and symlink creation
- Add integration tests for complete build workflow
- Add test infrastructure: Makefiles, CI/CD workflow, test runner
- Add comprehensive documentation (TESTING.md, tests/README.md)
- Add test fixtures and helper functions
- Support test execution via 'make test' command

Test Coverage:
- SPEC file structure validation
- SHA256 checksum verification
- Package dependency checks
- RPM installation symlinks
- End-to-end build process

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: philyuchkoff

.bats-core

@@ -0,0 +1,4 @@
+# Bats configuration
+--jobs
+--no-parallelize-across-files
+--no-tempdir-cleanup

.github/workflows/test.yml

@@ -0,0 +1,54 @@
+name: Tests
+
+on:
+  push:
+    branches: [ master, main ]
+  pull_request:
+    branches: [ master, main ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        distro:
+          - ubuntu-latest
+          - centos:latest
+          - alpine:latest
+
+    container:
+      image: ${{ matrix.distro }}
+
+    steps:
+    - name: Install dependencies (Ubuntu/Debian)
+      if: contains(matrix.distro, 'ubuntu')
+      run: |
+        apt-get update
+        apt-get install -y git bats curl rpmbuild gcc make perl
+
+    - name: Install dependencies (CentOS)
+      if: contains(matrix.distro, 'centos')
+      run: |
+        yum install -y git bats
+        yum groupinstall -y "Development Tools"
+        yum install -y rpm-build perl curl
+
+    - name: Install dependencies (Alpine)
+      if: contains(matrix.distro, 'alpine')
+      run: |
+        apk add git bats curl gcc make perl
+
+    - uses: actions/checkout@v3
+
+    - name: Run tests
+      run: |
+        cd tests
+        make test-ci
+
+    - name: Upload test results
+      if: failure()
+      uses: actions/upload-artifact@v3
+      with:
+        name: test-results-${{ matrix.distro }}
+        path: tests/test-*.log

Makefile

@@ -0,0 +1,67 @@
+.PHONY: test install help clean all
+
+# Default target
+all:
+	@echo "OpenSSL RPM Builder"
+	@echo "Run 'make help' for available commands"
+
+# Install OpenSSL 3.x
+install:
+	@echo "Installing OpenSSL 3.x..."
+	@if [ -f install-openssl_3.sh ]; then
+		sudo ./install-openssl_3.sh
+	else
+		echo "Error: install-openssl_3.sh not found"
+		exit 1
+	fi
+
+# Install OpenSSL 1.1.1
+install-1.1.1:
+	@echo "Installing OpenSSL 1.1.1..."
+	@if [ -f install-openssl_1.1.1.sh ]; then
+		sudo ./install-openssl_1.1.1.sh
+	else
+		echo "Error: install-openssl_1.1.1.sh not found"
+		exit 1
+	fi
+
+# Run tests
+test:
+	@echo "Running test suite..."
+	@cd tests && $(MAKE) test
+
+# Install test dependencies
+test-setup:
+	@cd tests && $(MAKE) test-deps
+
+# Build both versions (for testing)
+build-test:
+	@echo "Building both OpenSSL versions for testing..."
+	@mkdir -p build-test
+	@VERSION=3.6.1 BUILD_ROOT=build-test/rpmbuild-3.6.1 ./install-openssl_3.sh
+	@VERSION=1.1.1w BUILD_ROOT=build-test/rpmbuild-1.1.1 ./install-openssl_1.1.1.sh
+
+# Clean
+clean:
+	@echo "Cleaning build artifacts..."
+	@rm -rf /root/rpmbuild
+	@rm -rf build-test
+	@rm -f *.rpm
+
+# Clean test artifacts
+clean-tests:
+	@cd tests && $(MAKE) clean
+
+# Help
+help:
+	@echo "Available targets:"
+	@echo "  install       - Install OpenSSL 3.x"
+	@echo "  install-1.1.1- Install OpenSSL 1.1.1"
+	@echo "  test         - Run all tests"
+	@echo "  test-setup   - Install test dependencies"
+	@echo "  build-test   - Build both versions for testing"
+	@echo "  clean        - Remove build artifacts"
+	@echo "  clean-tests  - Remove test artifacts"
+	@echo "  help         - Show this help"
+	@echo ""
+	@echo "For more test options, use: cd tests && make help"

TESTING.md

@@ -0,0 +1,148 @@
+# Testing Guide
+
+This document explains the testing strategy for OpenSSL RPM Builder.
+
+## Test Suite Overview
+
+The test suite is organized into:
+- **Unit Tests**: Test individual components in isolation
+- **Integration Tests**: Test the complete workflow
+- **Fixtures**: Mock objects and test data
+
+## Core Test Areas
+
+### 1. SPEC File Generation (`test_spec_generation.bats`)
+Validates that generated RPM SPEC files:
+- Have correct metadata (name, version, license)
+- Include proper dependencies
+- Define correct file paths
+- Set up build instructions correctly
+
+### 2. Checksum Verification (`test_checksum_verification.bats`)
+Ensures file integrity checking:
+- Accepts valid checksums
+- Rejects invalid checksums
+- Handles missing files gracefully
+- Detects corrupted files
+
+### 3. Dependency Installation (`test_dependency_installation.bats`)
+Tests package manager integration:
+- Installs required packages
+- Handles version-specific dependencies
+- Properly removes conflicting packages
+- Gracefully handles missing packages
+
+### 4. Symlink Creation (`test_symlink_creation.bats`)
+Verifies system integration:
+- Creates correct symbolic links
+- Maintains proper permissions
+- Points to correct targets
+- Replaces old symlinks on reinstallation
+
+### 5. Full Build (`test_full_build.bats`)
+Integration tests covering:
+- Complete build workflow
+- Error handling paths
+- Multiple version support
+
+## Running Tests
+
+### Quick Start
+```bash
+# Install dependencies
+make test-setup
+
+# Run all tests
+make test
+
+# Run with verbose output
+make test-verbose
+```
+
+### Advanced Options
+```bash
+# Using the test runner directly
+./tests/run_tests.sh --help
+
+# Specific test types
+./tests/run_tests.sh --unit --verbose
+./tests/run_tests.sh --integration --ci
+```
+
+## Continuous Integration
+
+The project includes GitHub Actions workflow that:
+- Tests on multiple distributions (Ubuntu, CentOS, Alpine)
+- Runs complete test suite
+- Provides failure diagnostics
+
+## Writing New Tests
+
+### Best Practices
+
+1. **Isolation**: Each test should be independent
+2. **Cleanup**: Use teardown to clean up temporary files
+3. **Mock External Services**: Test without network dependencies
+4. **Test Failures**: Verify error handling works correctly
+
+### Test Structure
+
+```bats
+#!/usr/bin/env bats
+
+load ../test_helpers  # Load helper functions
+
+setup() {
+    # Runs before each test
+    export TEST_TEMP_DIR=$(mktemp -d)
+}
+
+teardown() {
+    # Runs after each test
+    rm -rf ${TEST_TEMP_DIR}
+}
+
+@test "describe what the test does" {
+    # Test implementation
+    [ "$result" = "expected" ]
+}
+
+@test "test error condition" {
+    run command_that_should_fail
+    [ "$status" -ne 0 ]
+    grep -q "error message" <<< "$output"
+}
+```
+
+## Coverage Reports
+
+To see which parts of the code are tested:
+
+```bash
+# Install bats-coverage
+npm install -g bats-coverage
+
+# Run with coverage
+bats-coverage tests/unit/
+```
+
+## Debugging Failed Tests
+
+1. **Verbose Mode**: `bats -v test_file.bats`
+2. **Trace Mode**: `bats --trace test_file.bats`
+3. **Interactive Debug**: Add `echo` statements in tests
+4. **Check Environment**: Ensure all dependencies are installed
+
+## Performance Testing
+
+For larger scale testing:
+
+```bash
+# Run tests multiple times
+for i in {1..100}; do
+    make test || ./notify-failure.sh
+done
+
+# Measure test runtime
+time make test
+```

tests/Makefile

@@ -0,0 +1,61 @@
+.PHONY: test test-unit test-integration test-deps clean help
+
+# Default target
+test:
+	@echo "Running all tests..."
+	@$(MAKE) test-deps
+	@$(MAKE) test-unit
+	@$(MAKE) test-integration
+
+# Run unit tests
+test-unit:
+	@echo "Running unit tests..."
+	@cd unit && bats -t *.bats
+
+# Run integration tests
+test-integration:
+	@echo "Running integration tests..."
+	@cd integration && bats -t *.bats
+
+# Install test dependencies
+test-deps:
+	@echo "Checking dependencies..."
+	@bash test_dependencies.sh
+
+# Clean up test artifacts
+clean:
+	@echo "Cleaning up..."
+	@rm -rf *.tmp
+	@rm -rf test-build-*
+
+# Continuous integration format (for CI/CD)
+test-ci:
+	@echo "Running tests in CI mode..."
+	@$(MAKE) test-deps
+	@cd unit && bats --formatter tap *.bats
+	@cd integration && bats --formatter tap *.bats
+
+# Verbose output
+test-verbose:
+	@echo "Running tests with verbose output..."
+	@$(MAKE) test-deps
+	@cd unit && bats -v *.bats
+	@cd integration && bats -v *.bats
+
+# Watch mode (requires entr tool)
+watch:
+	@echo "Running tests in watch mode..."
+	@find . -name "*.bats" | entr -r $(MAKE) test
+
+# Help target
+help:
+	@echo "Available targets:"
+	@echo "  test         - Run all tests"
+	@echo "  test-unit    - Run unit tests only"
+	@echo "  test-integration - Run integration tests only"
+	@echo "  test-deps    - Check test dependencies"
+	@echo "  test-ci      - Run tests in TAP format (CI)"
+	@echo "  test-verbose - Run tests with verbose output"
+	@echo "  watch        - Run tests on file changes (requires entr)"
+	@echo "  clean        - Clean test artifacts"
+	@echo "  help         - Show this help"