Prepare Active Postgres for Ruby 4

Author: gauravtiwari

.github/dependabot.yml

@@ -0,0 +1,38 @@
+version: 2
+updates:
+  - package-ecosystem: bundler
+    directory: "/"
+    schedule:
+      interval: weekly
+      day: monday
+      time: "06:20"
+      timezone: "Etc/UTC"
+    open-pull-requests-limit: 5
+    labels: [dependencies]
+    commit-message:
+      prefix: deps
+      include: scope
+    groups:
+      bundler-security:
+        applies-to: security-updates
+        patterns: ["*"]
+      bundler-minor-patch:
+        applies-to: version-updates
+        patterns: ["*"]
+        update-types: [minor, patch]
+
+  - package-ecosystem: github-actions
+    directory: "/"
+    schedule:
+      interval: weekly
+      day: monday
+      time: "06:40"
+      timezone: "Etc/UTC"
+    labels: [dependencies]
+    commit-message:
+      prefix: deps
+      include: scope
+    groups:
+      actions-minor-patch:
+        patterns: ["*"]
+        update-types: [minor, patch]

.github/workflows/ci.yml

@@ -2,86 +2,37 @@ name: CI
 
 on:
   push:
-    branches: [ main, develop ]
+    branches: [ main ]
   pull_request:
-    branches: [ main, develop ]
+    branches: [ main ]
+  workflow_dispatch:
 
 permissions:
   contents: read
 
 jobs:
-  test:
+  verify:
     runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        ruby-version: ['3.3', '3.4']
 
     steps:
-    - uses: actions/checkout@v4
-
-    - name: Set up Ruby ${{ matrix.ruby-version }}
-      uses: ruby/setup-ruby@v1
-      with:
-        ruby-version: ${{ matrix.ruby-version }}
-        bundler-cache: true
-
-    - name: Install dependencies
-      run: bundle install
-
-    - name: Run tests
-      run: bundle exec rake test
-
-    - name: Upload coverage reports
-      uses: codecov/codecov-action@v4
-      if: matrix.ruby-version == '3.4'
+    - uses: actions/checkout@v6
       with:
-        files: ./coverage/.resultset.json
-        fail_ci_if_error: false
-
-  lint:
-    runs-on: ubuntu-latest
-
-    steps:
-    - uses: actions/checkout@v4
+        persist-credentials: false
 
     - name: Set up Ruby
       uses: ruby/setup-ruby@v1
       with:
-        ruby-version: '3.4'
+        ruby-version: '4.0.6'
         bundler-cache: true
 
-    - name: Install dependencies
-      run: bundle install
+    - name: Run tests
+      run: bundle exec rake test
 
     - name: Run RuboCop
-      run: bundle exec rubocop --format progress --format json --out rubocop-results.json
-      continue-on-error: true
-
-    - name: Upload RuboCop results
-      uses: actions/upload-artifact@v4
-      if: always()
-      with:
-        name: rubocop-results
-        path: rubocop-results.json
+      run: bundle exec rubocop
 
-  build:
-    runs-on: ubuntu-latest
-    needs: [test, lint]
-
-    steps:
-    - uses: actions/checkout@v4
-
-    - name: Set up Ruby
-      uses: ruby/setup-ruby@v1
-      with:
-        ruby-version: '3.4'
-        bundler-cache: true
+    - name: Audit dependencies
+      run: bundle exec bundle-audit check --update
 
     - name: Build gem
-      run: bundle exec rake build
-
-    - name: Upload gem artifact
-      uses: actions/upload-artifact@v4
-      with:
-        name: gem-package
-        path: pkg/*.gem
+      run: gem build active_postgres.gemspec

.gitignore

@@ -1,3 +1,8 @@
 *.gem
+.bundle/
+vendor/
 coverage/
+pkg/
+tmp/
 .byebug_history
+.DS_Store

.rubocop.yml

@@ -1,6 +1,6 @@
 AllCops:
   NewCops: enable
-  TargetRubyVersion: 3.3
+  TargetRubyVersion: 4.0
   SuggestExtensions: false
   Exclude:
     - 'vendor/**/*'
@@ -14,18 +14,26 @@ Layout/LineLength:
 Metrics/MethodLength:
   Max: 35
   Exclude:
+    - 'lib/active_postgres/configuration.rb'
     - 'lib/active_postgres/components/repmgr.rb'
     - 'lib/active_postgres/connection_pooler.rb'
     - 'lib/active_postgres/generators/active_postgres/install_generator.rb'
     - 'lib/active_postgres/performance_tuner.rb'
     - 'lib/active_postgres/ssh_executor.rb'
+    - 'lib/active_postgres/health_checker.rb'
+    - 'lib/active_postgres/overview.rb'
+    - 'test/components/pgbouncer_test.rb'
 
 Metrics/ClassLength:
   Max: 250
   Exclude:
     - 'lib/active_postgres/components/repmgr.rb'
     - 'lib/active_postgres/connection_pooler.rb'
     - 'lib/active_postgres/ssh_executor.rb'
+    - 'lib/active_postgres/components/pgbouncer.rb'
+    - 'lib/active_postgres/health_checker.rb'
+    - 'lib/active_postgres/overview.rb'
+    - 'test/components/pgbouncer_test.rb'
 
 Metrics/AbcSize:
   Max: 40
@@ -36,26 +44,42 @@ Metrics/AbcSize:
     - 'lib/active_postgres/performance_tuner.rb'
     - 'lib/active_postgres/ssh_executor.rb'
     - 'lib/active_postgres/validator.rb'
+    - 'lib/active_postgres/components/pgbouncer.rb'
+    - 'lib/active_postgres/configuration.rb'
+    - 'lib/active_postgres/health_checker.rb'
+    - 'lib/active_postgres/overview.rb'
 
 Metrics/CyclomaticComplexity:
   Max: 12
   Exclude:
     - 'lib/active_postgres/components/repmgr.rb'
     - 'lib/active_postgres/connection_pooler.rb'
     - 'lib/active_postgres/generators/active_postgres/install_generator.rb'
+    - 'lib/active_postgres/configuration.rb'
+    - 'lib/active_postgres/error_handler.rb'
+    - 'lib/active_postgres/health_checker.rb'
+    - 'lib/active_postgres/overview.rb'
+    - 'test/test_helper.rb'
 
 Metrics/PerceivedComplexity:
   Max: 12
   Exclude:
     - 'lib/active_postgres/components/repmgr.rb'
     - 'lib/active_postgres/connection_pooler.rb'
     - 'lib/active_postgres/generators/active_postgres/install_generator.rb'
+    - 'lib/active_postgres/configuration.rb'
+    - 'lib/active_postgres/error_handler.rb'
+    - 'lib/active_postgres/health_checker.rb'
+    - 'lib/active_postgres/overview.rb'
+    - 'test/test_helper.rb'
 
 Metrics/BlockLength:
   Enabled: false
 
 Metrics/ParameterLists:
   Max: 6
+  Exclude:
+    - 'lib/active_postgres/ssh_executor.rb'
 
 Style/Documentation:
   Enabled: false
@@ -82,5 +106,14 @@ Lint/FormatParameterMismatch:
   Exclude:
     - 'lib/active_postgres/performance_tuner.rb'
 
-Gemspec/DevelopmentDependencies:
-  Enabled: false
+Naming/VariableNumber:
+  Exclude:
+    - 'test/components/pgbouncer_templates_test.rb'
+
+Style/TrivialAccessors:
+  Exclude:
+    - 'test/components/pgbouncer_test.rb'
+
+Style/CombinableLoops:
+  Exclude:
+    - 'lib/active_postgres/components/repmgr.rb'

.ruby-version

@@ -0,0 +1 @@
+4.0.6

CHANGELOG.md

@@ -0,0 +1,21 @@
+# Changelog
+
+All notable changes to Active Postgres will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project follows [Semantic Versioning](https://semver.org/).
+
+## Unreleased
+
+### Changed
+
+- Require Ruby 4.0 or newer and Rails 8.1 or newer for Rails integration.
+- Align runtime and development dependencies with the maintained toolchain.
+- Add blocking test, lint, dependency-audit, and package-build CI checks.
+- Add automated Bundler and GitHub Actions dependency updates.
+- Document network, credential, failover, and recovery responsibilities.
+
+## 0.9.5
+
+- Current published release. See the repository history for changes included in
+  earlier releases.

CONTRIBUTING.md

@@ -0,0 +1,19 @@
+# Contributing
+
+Bug reports and focused pull requests are welcome. For a security issue, follow
+[SECURITY.md](SECURITY.md) instead of opening a public issue.
+
+Set up Ruby 4.0.6, install the bundle, and run the local verification commands:
+
+```sh
+bundle install
+bundle exec rake test
+bundle exec rubocop
+bundle exec bundle-audit check --update
+gem build active_postgres.gemspec
+```
+
+Keep deployment changes narrow and include tests for generated PostgreSQL,
+PgBouncer, repmgr, backup, and monitoring configuration. Changes affecting
+failover or recovery should document how they were exercised in a disposable
+environment.

Gemfile

@@ -1,7 +1,14 @@
 source 'https://rubygems.org'
 
+ruby '>= 4.0.0'
+
 gemspec
 
-gem 'minitest', '~> 5.0'
-gem 'rake', '~> 13.0'
-gem 'rubocop', '~> 1.50'
+group :development, :test do
+  gem 'bundler-audit', '~> 0.9', require: false
+  gem 'minitest', '~> 6.0'
+  gem 'minitest-mock', '~> 5.27'
+  gem 'rake', '~> 13.4'
+  gem 'rubocop', '~> 1.89', require: false
+  gem 'simplecov', '~> 1.1', require: false
+end