feat: Add comprehensive installer infrastructure

- Fix setup.py placeholder values and dependency issues
- Add modern pyproject.toml build configuration
- Create PyInstaller-compatible standalone entry point
- Fix CI/CD workflows for implementations/python/ structure
- Add cross-platform installer workflow with GitHub Actions
- Support Windows, macOS, Linux executable generation
- Include professional install scripts with PATH integration

Resolves installer creation and distribution capabilities.

Author: jonobg

.github/workflows/build-installers.yml

@@ -0,0 +1,234 @@
+name: Build Installers
+
+on:
+  push:
+    tags:
+      - 'v*.*.*'
+  workflow_dispatch:
+
+jobs:
+  build-python-executable:
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        include:
+          - os: ubuntu-latest
+            executable_name: cfgpp
+            artifact_name: cfgpp-linux-x64
+          - os: windows-latest
+            executable_name: cfgpp.exe
+            artifact_name: cfgpp-windows-x64
+          - os: macos-latest
+            executable_name: cfgpp
+            artifact_name: cfgpp-macos-x64
+
+    runs-on: ${{ matrix.os }}
+    
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Python 3.9
+      uses: actions/setup-python@v4
+      with:
+        python-version: 3.9
+    
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install pyinstaller
+        cd implementations/python
+        pip install -e .
+    
+    - name: Build executable with PyInstaller
+      run: |
+        cd implementations/python
+        if [ "${{ matrix.os }}" == "windows-latest" ]; then
+          pyinstaller --onefile --name cfgpp --console src/cfgpp_standalone.py
+        else
+          pyinstaller --onefile --name cfgpp --console src/cfgpp_standalone.py
+        fi
+      shell: bash
+    
+    - name: Test executable
+      run: |
+        cd implementations/python/dist
+        if [ "${{ matrix.os }}" == "windows-latest" ]; then
+          ./cfgpp.exe --help
+        else
+          ./cfgpp --help
+        fi
+      shell: bash
+    
+    - name: Create installer package
+      run: |
+        cd implementations/python
+        mkdir -p installer
+        # Copy executable
+        if [ "${{ matrix.os }}" == "windows-latest" ]; then
+          cp dist/cfgpp.exe installer/
+        else
+          cp dist/cfgpp installer/
+        fi
+        cp README.md installer/
+        cp ../../LICENSE installer/ || echo "No LICENSE file found"
+        
+        # Create install script for Unix systems
+        if [ "${{ matrix.os }}" != "windows-latest" ]; then
+          cat > installer/install.sh << 'EOF'
+        #!/bin/bash
+        # CFGPP Installer Script
+        
+        INSTALL_DIR="$HOME/.local/bin"
+        EXECUTABLE_NAME="cfgpp"
+        
+        echo "Installing CFGPP Configuration Parser..."
+        
+        # Create install directory if it doesn't exist
+        mkdir -p "$INSTALL_DIR"
+        
+        # Copy executable
+        cp "$EXECUTABLE_NAME" "$INSTALL_DIR/"
+        chmod +x "$INSTALL_DIR/$EXECUTABLE_NAME"
+        
+        echo "CFGPP installed to $INSTALL_DIR/$EXECUTABLE_NAME"
+        echo ""
+        echo "Add $INSTALL_DIR to your PATH if not already present:"
+        echo "  export PATH=\"\$PATH:$INSTALL_DIR\""
+        echo ""
+        echo "Test installation:"
+        echo "  cfgpp --help"
+        EOF
+          chmod +x installer/install.sh
+        fi
+        
+        # Create install script for Windows
+        if [ "${{ matrix.os }}" == "windows-latest" ]; then
+          cat > installer/install.bat << 'EOF'
+        @echo off
+        REM CFGPP Installer Script for Windows
+        
+        set "INSTALL_DIR=%LOCALAPPDATA%\cfgpp"
+        set "EXECUTABLE_NAME=cfgpp.exe"
+        
+        echo Installing CFGPP Configuration Parser...
+        
+        REM Create install directory
+        if not exist "%INSTALL_DIR%" mkdir "%INSTALL_DIR%"
+        
+        REM Copy executable
+        copy "%EXECUTABLE_NAME%" "%INSTALL_DIR%\"
+        
+        echo CFGPP installed to %INSTALL_DIR%\%EXECUTABLE_NAME%
+        echo.
+        echo Add %INSTALL_DIR% to your PATH environment variable
+        echo Test installation: cfgpp --help
+        
+        pause
+        EOF
+        fi
+      shell: bash
+    
+    - name: Create archive
+      run: |
+        cd implementations/python/installer
+        if [ "${{ matrix.os }}" == "windows-latest" ]; then
+          7z a ../${{ matrix.artifact_name }}.zip *
+        else
+          tar -czf ../${{ matrix.artifact_name }}.tar.gz *
+        fi
+      shell: bash
+    
+    - name: Upload installer artifacts
+      uses: actions/upload-artifact@v3
+      with:
+        name: ${{ matrix.artifact_name }}
+        path: |
+          implementations/python/${{ matrix.artifact_name }}.zip
+          implementations/python/${{ matrix.artifact_name }}.tar.gz
+
+  create-release:
+    needs: build-python-executable
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/v')
+    
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Download all artifacts
+      uses: actions/download-artifact@v3
+    
+    - name: Generate release notes
+      run: |
+        VERSION=${GITHUB_REF#refs/tags/v}
+        echo "VERSION=$VERSION" >> $GITHUB_ENV
+        
+        cat > RELEASE_NOTES.md << EOF
+        # CFGPP v$VERSION - Configuration Parser & Tools
+        
+        ## Installation Options
+        
+        ### Option 1: Python Package (Recommended)
+        \`\`\`bash
+        pip install cfgpp
+        \`\`\`
+        
+        ### Option 2: Standalone Executables
+        Download the appropriate executable for your platform:
+        
+        - **Windows**: cfgpp-windows-x64.zip
+        - **macOS**: cfgpp-macos-x64.tar.gz  
+        - **Linux**: cfgpp-linux-x64.tar.gz
+        
+        Extract and run the included install script, or manually place the executable in your PATH.
+        
+        ## Usage
+        \`\`\`bash
+        cfgpp --help                    # Show help
+        cfgpp parse config.cfgpp        # Parse configuration file
+        cfgpp validate config.cfgpp     # Validate syntax
+        cfgpp format config.cfgpp       # Format configuration
+        \`\`\`
+        
+        ## Features
+        - Robust bracket-based syntax (no indentation sensitivity)
+        - Environment variable interpolation: \${VAR:-default}
+        - Include/import functionality with circular detection
+        - Expression evaluation and string operations
+        - Cross-platform CLI tools
+        
+        ## Changes in this Release
+        EOF
+        
+        # Get commits since last tag
+        LAST_TAG=$(git describe --tags --abbrev=0 HEAD~1 2>/dev/null || echo "")
+        if [ -n "$LAST_TAG" ]; then
+          git log --pretty=format:"- %s" $LAST_TAG..HEAD >> RELEASE_NOTES.md
+        else
+          echo "- Initial release with comprehensive installer support" >> RELEASE_NOTES.md
+        fi
+    
+    - name: Create GitHub Release
+      uses: actions/create-release@v1
+      id: create_release
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      with:
+        tag_name: ${{ github.ref }}
+        release_name: CFGPP v${{ env.VERSION }}
+        body_path: RELEASE_NOTES.md
+        draft: false
+        prerelease: false
+    
+    - name: Upload Release Assets
+      run: |
+        # Find and upload all installer archives
+        find . -name "*.zip" -o -name "*.tar.gz" | while read file; do
+          if [[ -f "$file" ]]; then
+            filename=$(basename "$file")
+            echo "Uploading $filename..."
+            curl -H "Authorization: token ${{ secrets.GITHUB_TOKEN }}" \
+                 -H "Content-Type: application/octet-stream" \
+                 --data-binary @"$file" \
+                 "${{ steps.create_release.outputs.upload_url }}?name=$filename"
+          fi
+        done

.github/workflows/ci.yml

@@ -36,18 +36,20 @@ jobs:
       uses: actions/cache@v3
       with:
         path: ~/.cache/pip
-        key: ${{ runner.os }}-pip-${{ hashFiles('**/setup.py') }}
+        key: ${{ runner.os }}-pip-${{ hashFiles('**/pyproject.toml', '**/requirements.txt') }}
         restore-keys: |
           ${{ runner.os }}-pip-
     
     - name: Install dependencies
       run: |
         python -m pip install --upgrade pip
+        cd implementations/python
         pip install -e .
         pip install pytest pytest-cov pytest-xdist
     
     - name: Run tests
       run: |
+        cd implementations/python
         pytest --cov=src/cfgpp --cov-report=xml --cov-report=term-missing -v
     
     - name: Upload coverage to Codecov
@@ -73,19 +75,23 @@ jobs:
       run: |
         python -m pip install --upgrade pip
         pip install black flake8 mypy
+        cd implementations/python
         pip install -e .
     
     - name: Check code formatting with Black
       run: |
+        cd implementations/python
         black --check --diff src/ tests/
     
     - name: Lint with flake8
       run: |
+        cd implementations/python
         flake8 src/ tests/ --count --select=E9,F63,F7,F82 --show-source --statistics
         flake8 src/ tests/ --count --exit-zero --max-complexity=10 --max-line-length=88 --statistics
     
     - name: Type check with mypy
       run: |
+        cd implementations/python
         mypy src/ --ignore-missing-imports
 
   security:
@@ -102,10 +108,12 @@ jobs:
       run: |
         python -m pip install --upgrade pip
         pip install bandit safety
+        cd implementations/python
         pip install -e .
     
     - name: Run security checks with bandit
       run: |
+        cd implementations/python
         bandit -r src/ -f json -o bandit-report.json || true
         bandit -r src/
     
@@ -126,6 +134,7 @@ jobs:
     - name: Install dependencies
       run: |
         python -m pip install --upgrade pip
+        cd implementations/python
         pip install -e .
     
     - name: Validate documentation links
@@ -181,6 +190,7 @@ jobs:
     - name: Install dependencies
       run: |
         python -m pip install --upgrade pip
+        cd implementations/python
         pip install -e .
     
     - name: Run integration tests
@@ -267,18 +277,21 @@ jobs:
       run: |
         python -m pip install --upgrade pip
         pip install build twine
+        cd implementations/python
         pip install -e .
     
     - name: Build package
       run: |
+        cd implementations/python
         python -m build
     
     - name: Check package
       run: |
+        cd implementations/python
         twine check dist/*
     
     - name: Upload build artifacts
       uses: actions/upload-artifact@v3
       with:
         name: dist
-        path: dist/
+        path: implementations/python/dist/

.github/workflows/release.yml

@@ -22,14 +22,17 @@ jobs:
       run: |
         python -m pip install --upgrade pip
         pip install build twine
+        cd implementations/python
         pip install -e .
     
     - name: Build package
       run: |
+        cd implementations/python
         python -m build
     
     - name: Check package
       run: |
+        cd implementations/python
         twine check dist/*
     
     - name: Generate changelog
@@ -66,7 +69,7 @@ jobs:
       uses: actions/upload-artifact@v3
       with:
         name: dist-${{ env.VERSION }}
-        path: dist/
+        path: implementations/python/dist/
 
     # Uncomment when ready to publish to PyPI
     # - name: Publish to PyPI

implementations/python/cfgpp.spec

@@ -0,0 +1,38 @@
+# -*- mode: python ; coding: utf-8 -*-
+
+
+a = Analysis(
+    ['src\\cfgpp_standalone.py'],
+    pathex=[],
+    binaries=[],
+    datas=[],
+    hiddenimports=[],
+    hookspath=[],
+    hooksconfig={},
+    runtime_hooks=[],
+    excludes=[],
+    noarchive=False,
+    optimize=0,
+)
+pyz = PYZ(a.pure)
+
+exe = EXE(
+    pyz,
+    a.scripts,
+    a.binaries,
+    a.datas,
+    [],
+    name='cfgpp',
+    debug=False,
+    bootloader_ignore_signals=False,
+    strip=False,
+    upx=True,
+    upx_exclude=[],
+    runtime_tmpdir=None,
+    console=True,
+    disable_windowed_traceback=False,
+    argv_emulation=False,
+    target_arch=None,
+    codesign_identity=None,
+    entitlements_file=None,
+)