v5 - Firebird ODBC Driver Modernization (fb-cpp edition)

.clang-format

@@ -0,0 +1,80 @@
+# Firebird ODBC Driver — clang-format configuration
+#
+# This configuration matches the existing codebase style as closely as possible.
+# Apply to NEW or MODIFIED code only — do not reformat the entire codebase.
+#
+# Usage:
+#   clang-format -i <file>              # Format a specific file
+#   clang-format --dry-run <file>       # Preview changes without applying
+#
+# To exclude legacy files from formatting, add them to .clang-format-ignore.
+
+Language: Cpp
+BasedOnStyle: LLVM
+
+# Indentation: tabs (matching existing codebase)
+UseTab: ForIndentation
+TabWidth: 4
+IndentWidth: 4
+ContinuationIndentWidth: 4
+
+# Column limit: generous to match existing wide lines
+ColumnLimit: 140
+
+# Braces: Allman style for functions (next line), attach for control flow
+# The codebase is inconsistent; Allman is the dominant pattern for functions.
+BreakBeforeBraces: Custom
+BraceWrapping:
+  AfterClass: true
+  AfterControlStatement: Never
+  AfterEnum: true
+  AfterFunction: true
+  AfterNamespace: true
+  AfterStruct: true
+  AfterUnion: true
+  BeforeCatch: false
+  BeforeElse: false
+  IndentBraces: false
+  SplitEmptyFunction: false
+  SplitEmptyRecord: false
+  SplitEmptyNamespace: false
+
+# Pointer/reference alignment: left (e.g., char* ptr)
+PointerAlignment: Left
+ReferenceAlignment: Left
+
+# Spaces
+SpaceAfterCStyleCast: true
+SpaceBeforeAssignmentOperators: true
+SpaceBeforeParens: ControlStatements
+SpacesInParentheses: false
+SpacesInSquareBrackets: false
+SpaceInEmptyBlock: false
+
+# Includes: keep existing order (do not sort automatically)
+SortIncludes: Never
+
+# Alignment
+AlignConsecutiveAssignments: false
+AlignConsecutiveDeclarations: false
+AlignConsecutiveMacros: true
+AlignTrailingComments: true
+
+# Short forms: allow short if/loops on one line
+AllowShortBlocksOnASingleLine: Empty
+AllowShortCaseLabelsOnASingleLine: false
+AllowShortFunctionsOnASingleLine: Inline
+AllowShortIfStatementsOnASingleLine: Never
+AllowShortLoopsOnASingleLine: false
+
+# Namespace indentation
+NamespaceIndentation: All
+
+# Other
+AccessModifierOffset: -4
+AllowAllParametersOfDeclarationOnNextLine: true
+BinPackArguments: true
+BinPackParameters: true
+FixNamespaceComments: false
+MaxEmptyLinesToKeep: 2
+ReflowComments: false

.github/workflows/build-and-test.yml

@@ -0,0 +1,205 @@
+name: Build and Test
+
+on:
+  push:
+    # Run only on branches, not tags, since release.yml handles tags. This ensures we don't run redundant builds for release tags.
+    branches:
+      - '**'
+  pull_request:
+  workflow_call:
+
+env:
+  VCPKG_ROOT: ${{ github.workspace }}/vcpkg
+  # Store vcpkg binary archives in a workspace-relative path so actions/cache
+  # can restore them before cmake runs, eliminating recompilation of ICU,
+  # Firebird, etc. on every run.
+  VCPKG_DEFAULT_BINARY_CACHE: ${{ github.workspace }}/vcpkg-bincache
+
+jobs:
+  build-and-test-windows:
+    runs-on: windows-latest
+    timeout-minutes: 30
+
+    steps:
+    - uses: actions/checkout@v6
+      with:
+        fetch-depth: 0
+        submodules: false
+
+    - name: Cache vcpkg submodule
+      id: cache-vcpkg-submodule-win
+      uses: actions/cache@v5
+      with:
+        path: vcpkg
+        key: vcpkg-submodule-windows-${{ hashFiles('.gitmodules') }}
+
+    - name: Cache PowerShell Modules
+      uses: actions/cache@v5
+      with:
+        path: |
+          ~/Documents/PowerShell/Modules/PSFirebird
+          ~/Documents/PowerShell/Modules/InvokeBuild
+        key: psmodules-windows-${{ hashFiles('install-prerequisites.ps1') }}
+        restore-keys: psmodules-windows-
+
+    - name: Fix cmd.exe AutoRun
+      shell: pwsh
+      run: |
+        # Some Windows images have a cmd.exe AutoRun that leaves ERRORLEVEL=1,
+        # which breaks Ninja builds (vcpkg uses Ninja internally).
+        Remove-ItemProperty -Path 'HKCU:\Software\Microsoft\Command Processor' -Name 'AutoRun' -ErrorAction SilentlyContinue
+        Remove-ItemProperty -Path 'HKLM:\Software\Microsoft\Command Processor' -Name 'AutoRun' -ErrorAction SilentlyContinue
+
+    - name: Initialize vcpkg submodule
+      if: steps.cache-vcpkg-submodule-win.outputs.cache-hit != 'true'
+      run: git submodule update --init vcpkg
+
+    - name: Create vcpkg binary cache directory
+      shell: pwsh
+      run: New-Item -ItemType Directory -Force "${{ github.workspace }}/vcpkg-bincache" | Out-Null
+
+    # Two-level vcpkg cache:
+    # Level 1 – binary archives: individual per-package .zip files used by vcpkg
+    #   to reinstall without compilation. restore-keys ensures a partial hit when
+    #   vcpkg.json changes; only the new/changed packages need compiling.
+    - name: Cache vcpkg binary archives
+      uses: actions/cache@v5
+      with:
+        path: ${{ github.workspace }}/vcpkg-bincache
+        key: vcpkg-bincache-windows-${{ hashFiles('vcpkg.json', 'vcpkg-configuration.json') }}
+        restore-keys: vcpkg-bincache-windows-
+        save-always: true
+
+    # Level 2 – installed tree: the fully-extracted build/vcpkg_installed directory.
+    #   On an exact key hit vcpkg detects all packages are already installed and
+    #   exits in under a second, making cmake configure nearly instantaneous.
+    - name: Cache vcpkg installed packages
+      uses: actions/cache@v5
+      with:
+        path: build/vcpkg_installed
+        key: vcpkg-installed-windows-${{ hashFiles('vcpkg.json', 'vcpkg-configuration.json') }}
+        restore-keys: vcpkg-installed-windows-
+        save-always: true
+
+    - name: Bootstrap vcpkg
+      shell: pwsh
+      run: |
+        if ($IsWindows) { & ./vcpkg/bootstrap-vcpkg.bat -disableMetrics }
+        else { & ./vcpkg/bootstrap-vcpkg.sh -disableMetrics }
+
+    - name: Install Prerequisites
+      shell: pwsh
+      run: ./install-prerequisites.ps1
+
+    - name: Build
+      shell: pwsh
+      run: Invoke-Build build -Configuration Release
+
+    - name: Run Tests
+      shell: pwsh
+      run: |
+        # Add DLL directories to PATH so test can find them
+        $env:PATH = "${{github.workspace}}/build/Release;${{github.workspace}}/build/bin/Release;$env:PATH"
+        Invoke-Build test -Configuration Release
+
+    - name: Upload Build Artifacts
+      uses: actions/upload-artifact@v7
+      if: success()
+      with:
+        name: windows-x64-binaries
+        path: |
+          ${{github.workspace}}/build/Release/*.dll
+          ${{github.workspace}}/build/Release/*.lib
+          ${{github.workspace}}/build/Release/*.pdb
+
+  build-and-test-linux:
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+
+    steps:
+    - uses: actions/checkout@v6
+      with:
+        fetch-depth: 0
+        submodules: false
+
+    - name: Install Dependencies
+      run: |
+        sudo apt-get update
+        sudo apt-get install -y unixodbc unixodbc-dev odbcinst cmake g++ \
+          autoconf autoconf-archive automake libtool pkg-config \
+          libncurses-dev libtommath-dev libatomic1
+        # PSFirebird needs to 'apt-get download' libncurses5/libtinfo5 packages.
+        # These don't exist in Ubuntu 24.04+ repos, so add Ubuntu 22.04 (jammy) as a fallback source.
+        if ! apt-cache show libncurses5 > /dev/null 2>&1; then
+          ARCH=$(dpkg --print-architecture)
+          echo "deb [arch=${ARCH}] http://archive.ubuntu.com/ubuntu/ jammy main universe" | sudo tee /etc/apt/sources.list.d/jammy.list
+          # For ARM64, use ports.ubuntu.com
+          if [ "$ARCH" = "arm64" ]; then
+            echo "deb [arch=${ARCH}] http://ports.ubuntu.com/ubuntu-ports/ jammy main universe" | sudo tee /etc/apt/sources.list.d/jammy.list
+          fi
+          sudo apt-get update
+        fi
+
+    - name: Cache vcpkg submodule
+      id: cache-vcpkg-submodule-linux
+      uses: actions/cache@v5
+      with:
+        path: vcpkg
+        key: vcpkg-submodule-linux-${{ hashFiles('.gitmodules') }}
+
+    - name: Initialize vcpkg submodule
+      if: steps.cache-vcpkg-submodule-linux.outputs.cache-hit != 'true'
+      run: git submodule update --init vcpkg
+
+    - name: Cache PowerShell Modules
+      uses: actions/cache@v5
+      with:
+        path: |
+          ~/.local/share/powershell/Modules/PSFirebird
+          ~/.local/share/powershell/Modules/InvokeBuild
+        key: psmodules-linux-${{ hashFiles('install-prerequisites.ps1') }}
+        restore-keys: psmodules-linux-
+
+    - name: Create vcpkg binary cache directory
+      shell: pwsh
+      run: New-Item -ItemType Directory -Force "${{ github.workspace }}/vcpkg-bincache" | Out-Null
+
+    - name: Cache vcpkg binary archives
+      uses: actions/cache@v5
+      with:
+        path: ${{ github.workspace }}/vcpkg-bincache
+        key: vcpkg-bincache-linux-${{ hashFiles('vcpkg.json', 'vcpkg-configuration.json') }}
+        restore-keys: vcpkg-bincache-linux-
+        save-always: true
+
+    - name: Cache vcpkg installed packages
+      uses: actions/cache@v5
+      with:
+        path: build/vcpkg_installed
+        key: vcpkg-installed-linux-${{ hashFiles('vcpkg.json', 'vcpkg-configuration.json') }}
+        restore-keys: vcpkg-installed-linux-
+        save-always: true
+
+    - name: Bootstrap vcpkg
+      run: ./vcpkg/bootstrap-vcpkg.sh -disableMetrics
+
+    - name: Install Prerequisites
+      shell: pwsh
+      run: ./install-prerequisites.ps1
+
+    - name: Build
+      shell: pwsh
+      run: Invoke-Build build -Configuration Release
+
+    - name: Run Tests
+      shell: pwsh
+      run: Invoke-Build test -Configuration Release
+
+    - name: Upload Build Artifacts
+      uses: actions/upload-artifact@v7
+      if: success()
+      with:
+        name: linux-x64-binaries
+        path: |
+          ${{github.workspace}}/build/*.so
+          ${{github.workspace}}/build/**/*.so