capistrano-ops 1.0.11 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b8c94fd6b958f219478ce26ed0631cd216f3b145701d55cd4192819ab9afecc5
-  data.tar.gz: fc29a70471fdd88d40ab72f17a3b5f0fd4aac4e71d93215143bc971778d4c070
+  metadata.gz: 708599bef12f8e7ce1b96a36fb09c1bc9acc4d50d871f2d1d5a3790240455096
+  data.tar.gz: 8c13bfc221324e6303f474453185f868d9984dba83da63de7715b747d9113594
 SHA512:
-  metadata.gz: c0d8bbebfdbe41493e8844f6dbca9561fa76e321d1c9024d76880d43aa1a001d941f556631df188c29958f28467f4deafd09bd999fb5c420be328e324adc1265
-  data.tar.gz: a8dbc8d0b748e510fa29ca51f56a6764b5daa0313503e011fd8e451e813105c83a2e844825b976521857f6378f7208d7102c4f263a2d5672030c73a554118e13
+  metadata.gz: 3bd6ada29edf5e6a3c077c35a83908d1b40e235b0f33497a33b309e7902ea4fe16910a078e41b5bd5feb58246d4903e31b31d32567d88341ec5847c89a435aa9
+  data.tar.gz: 2d987eaaab73c8c5a6f595226371c8979d816656e3014fa744b1725bb27dff4e82cdd66d79e92dcc89fd2963dc03f5c3e6f5ede7a85c0fc33f639c7ff9e0dcfa

data/.github/dependabot.yml

@@ -0,0 +1,18 @@
+version: 2
+updates:
+  - package-ecosystem: bundler
+    directory: "/"
+    schedule:
+      interval: weekly
+    open-pull-requests-limit: 5
+    labels:
+      - dependencies
+      - ruby
+
+  - package-ecosystem: github-actions
+    directory: "/"
+    schedule:
+      interval: weekly
+    labels:
+      - dependencies
+      - ci

data/.github/workflows/ci.yml

@@ -0,0 +1,44 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  lint:
+    name: RuboCop
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version-file: .ruby-version
+          bundler-cache: true
+      - run: bundle exec rubocop --parallel
+
+  audit:
+    name: bundler-audit
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version-file: .ruby-version
+          bundler-cache: true
+      - run: bundle exec bundle-audit check --update
+
+  test:
+    name: RSpec (Ruby ${{ matrix.ruby }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby: ['3.2', '3.3', '3.4']
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+          bundler-cache: true
+      - run: bundle exec rspec

data/.github/workflows/release.yml

@@ -19,7 +19,7 @@ jobs:
       - name: Set up Ruby
         uses: ruby/setup-ruby@v1
         with:
-          ruby-version: '3.3'
+          ruby-version-file: .ruby-version
           bundler-cache: true
 
       - uses: rubygems/release-gem@v1

data/.gitignore

@@ -1,4 +1,5 @@
 /.bundle/
+/.ruby-lsp/
 /.yardoc
 /Gemfile.lock
 /_yardoc/

data/.rspec

@@ -0,0 +1,3 @@
+--require spec_helper
+--format documentation
+--color

data/.rubocop.yml

@@ -1,13 +1,16 @@
-# RuboCop configuration for ms-graph-mailer gem
+inherit_from: .rubocop_todo.yml
+
+# RuboCop configuration for capistrano-ops gem
 
 AllCops:
   NewCops: enable
-  TargetRubyVersion: 3.1
+  TargetRubyVersion: 3.2
   SuggestExtensions: false
   Exclude:
     - 'vendor/**/*'
     - 'tmp/**/*'
     - 'bin/**/*'
+    - 'lib/capistrano/ops/local/**/*'
 
 # Metrics
 
@@ -78,9 +81,6 @@ Layout/SpaceAroundMethodCallOperator:
 Gemspec/DevelopmentDependencies:
   Enabled: false
 
-Gemspec/RequireMFA:
-  Enabled: false
-
 Lint/RaiseException:
   Enabled: true
 

data/.rubocop_todo.yml

@@ -0,0 +1,55 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config --auto-gen-only-exclude --no-auto-gen-timestamp`
+# using RuboCop version 1.91.0.
+# The point is for the user to remove these configuration records
+# one by one as the offenses are removed from the code base.
+# Note that changes in the inspected code, or installation of new
+# versions of RuboCop, may require this file to be generated again.
+
+# Offense count: 3
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: Max, AllowHeredoc, AllowURI, AllowQualifiedName, URISchemes, AllowRBSInlineAnnotation, AllowCopDirectives, AllowedPatterns, SplitStrings.
+# URISchemes: http, https
+Layout/LineLength:
+  Exclude:
+    - 'lib/capistrano/ops/rails/lib/tasks/pg/dump.rake'
+    - 'lib/capistrano/ops/rails/lib/tasks/storage/storage_helper.rb'
+
+# Offense count: 1
+# Configuration parameters: CountComments, Max, CountAsOne.
+Metrics/ClassLength:
+  Exclude:
+    - 'lib/capistrano/ops/rails/lib/backup/s3.rb'
+
+# Offense count: 1
+# Configuration parameters: AllowedMethods, AllowedPatterns, Max.
+Metrics/CyclomaticComplexity:
+  Exclude:
+    - 'lib/capistrano/ops/rails/lib/backup/s3.rb'
+
+# Offense count: 1
+# Configuration parameters: AllowedMethods, AllowedPatterns, Max.
+Metrics/PerceivedComplexity:
+  Exclude:
+    - 'lib/capistrano/ops/rails/lib/backup/s3.rb'
+
+# Offense count: 2
+# Configuration parameters: Mode, AllowedMethods, AllowedPatterns, AllowBangMethods, WaywardPredicates.
+# AllowedMethods: call
+# WaywardPredicates: infinite?, nonzero?
+Naming/PredicateMethod:
+  Exclude:
+    - 'lib/capistrano/ops/figaro_yml/helpers.rb'
+    - 'lib/capistrano/ops/logrotate/helpers.rb'
+
+# Offense count: 1
+Style/MultilineBlockChain:
+  Exclude:
+    - 'lib/capistrano/ops/figaro_yml/helpers.rb'
+
+# Offense count: 1
+# Configuration parameters: AllowedMethods.
+# AllowedMethods: respond_to_missing?
+Style/OptionalBooleanParameter:
+  Exclude:
+    - 'lib/capistrano/ops/rails/lib/tasks/storage/storage_helper.rb'

data/.ruby-version

@@ -1 +1 @@
-3.1.4
+3.4.10

data/CHANGELOG.md

@@ -7,6 +7,41 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.1.0] - 2026-09-18
+
+### Added
+
+- Add CI workflow (`.github/workflows/ci.yml`) with a Ruby matrix (3.2, 3.3, 3.4) running RSpec, plus separate RuboCop and bundler-audit jobs
+- Add Dependabot config for weekly `bundler` and `github-actions` updates
+- Add `bundler-audit` dev-dependency and Rake task
+- Add minimal spec harness (`spec/spec_helper.rb`, `.rspec`, version smoke spec)
+- Add `.rubocop_todo.yml` baseline for new cops that would require API-shape changes (metrics, predicate naming, keyword args)
+
+### Changed
+
+- Widen `required_ruby_version` to `>= 3.2` (previously `>= 3.1.4, < 3.4.0` — blocked Ruby 3.4/3.5)
+- Add version bounds for `rails` (`>= 7.2, < 9`), `faraday` (`>= 2.0, < 3.0`) and `nokogiri` (`>= 1.15`)
+- Bump `.ruby-version` to `3.4.10`; release workflow now reads it via `ruby-version-file`
+- Bump `.rubocop.yml` `TargetRubyVersion` to `3.2` and enable `Gemspec/RequireMFA`
+- Bump dev-dependencies: `bundler >= 2.4, < 5`, `rubocop ~> 1.80`, `rubocop-rake ~> 0.7`, `rubocop-rspec ~> 3.0`
+- `rake` default now runs `spec` + `rubocop`
+
+### Removed
+
+- Remove obsolete `.travis.yml` (Travis CI is end-of-life)
+- Remove stray `release.gem` build artifact from repo root
+- Remove dead `lib/capistrano/ops/capistrano/v3/tasks/backup.rake`: never wired into `TaskLoader`, required a non-existent `backup_helper` file, and its deprecated tasks (`backup:create` / `backup:pull`) had been superseded by `backup:database:*`
+
+### Fixed
+
+- Fix `NameError` in `Notification::Webhook#backup_notification` when notification level was `error` on a successful backup (`_notification_level` param was referenced without the underscore)
+- Fix `bin/console`: required non-existent `capistrano/rake`; now requires `capistrano/ops`
+- Correct copy-paste header in `.rubocop.yml` (was labeled for `ms-graph-mailer`)
+
+### Docs
+
+- Clarify optional runtime dependencies (`whenever`, `figaro`, `wicked_pdf`) in README; state Ruby and Rails floors explicitly
+
 ## [1.0.11] - 2025-12-22
 
 ### Added
@@ -276,7 +311,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Figaro YAML management
 - Basic Capistrano integration
 
-[Unreleased]: https://github.com/zauberware/capistrano-ops/compare/v1.0.11...HEAD
+[Unreleased]: https://github.com/zauberware/capistrano-ops/compare/v1.1.0...HEAD
+[1.1.0]: https://github.com/zauberware/capistrano-ops/releases/tag/v1.1.0
 [1.0.11]: https://github.com/zauberware/capistrano-ops/releases/tag/v1.0.11
 [v1.0.10]: https://github.com/zauberware/capistrano-ops/compare/v1.0.9...v1.0.10
 [v1.0.9]: https://github.com/zauberware/capistrano-ops/compare/v1.0.8...v1.0.9

data/README.md

@@ -78,14 +78,23 @@ The capistrano-ops gem is a valuable library, tailor-made for Rails DevOps profe
 
 ## Requirements
 
-```ruby
-'capistrano', '~> 3.0'
-'whenever' # for scheduling tasks
-'figaro' # for environment variables if you use figaro_yml tasks
+Runtime requirements pulled in by the gem itself:
+
+- Ruby `>= 3.2`
+- Rails `>= 7.2, < 9`
+- `capistrano ~> 3.0` (in your app)
+
+Optional runtime dependencies — the corresponding task groups are only
+loaded when the gem is present in your `Gemfile`:
 
-# hint: if you use other aws-sdk gems, its possible that you have to update them too
+```ruby
+gem 'whenever'    # enables whenever:show_crontab
+gem 'figaro'      # enables figaro_yml:* tasks
+gem 'wicked_pdf'  # enables wkhtmltopdf:setup (with wkhtmltopdf-binary)
 ```
 
+> hint: if you use other aws-sdk gems, it's possible that you have to update them too
+
 [↑](#)
 
 ## Installation

data/Rakefile

@@ -2,10 +2,14 @@
 
 require 'bundler/gem_tasks'
 require 'rspec/core/rake_task'
+require 'rubocop/rake_task'
+require 'bundler/audit/task'
 
 RSpec::Core::RakeTask.new(:spec)
+RuboCop::RakeTask.new
+Bundler::Audit::Task.new
 
-task default: :spec
+task default: %i[spec rubocop]
 
 namespace :version do
   desc 'Bump patch version (0.1.0 -> 0.1.1)'

data/bin/console

@@ -2,7 +2,7 @@
 # frozen_string_literal: true
 
 require 'bundler/setup'
-require 'capistrano/rake'
+require 'capistrano/ops'
 
 # You can add fixtures and/or initialization code here to make experimenting
 # with your gem easier. You can also use a different console, if you like.

data/capistrano-ops.gemspec

@@ -18,15 +18,17 @@ Gem::Specification.new do |s|
   s.executables   = `git ls-files -- bin/*`.split("\n").map { |f| File.basename(f) }
   s.require_paths = ['lib']
 
-  s.required_ruby_version = '>= 3.1.4', '< 3.4.0'
+  s.required_ruby_version = '>= 3.2'
   s.add_dependency 'aws-sdk-s3', '~> 1.208'
-  s.add_dependency 'faraday'
-  s.add_dependency 'nokogiri'
-  s.add_dependency 'rails'
-  s.add_development_dependency 'bundler', '~> 2.0'
+  s.add_dependency 'faraday', '>= 2.0', '< 3.0'
+  s.add_dependency 'nokogiri', '>= 1.15'
+  s.add_dependency 'rails', '>= 7.2', '< 9'
+  s.add_development_dependency 'bundler', '>= 2.4', '< 5'
+  s.add_development_dependency 'bundler-audit', '~> 0.9'
   s.add_development_dependency 'rake', '~> 13.0'
   s.add_development_dependency 'rspec', '~> 3.0'
-  s.add_development_dependency 'rubocop', '~> 1.0'
-  s.add_development_dependency 'rubocop-rake', '~> 0.6'
-  s.add_development_dependency 'rubocop-rspec', '~> 2.0'
+  s.add_development_dependency 'rubocop', '~> 1.80'
+  s.add_development_dependency 'rubocop-rake', '~> 0.7'
+  s.add_development_dependency 'rubocop-rspec', '~> 3.0'
+  s.metadata['rubygems_mfa_required'] = 'true'
 end

data/lib/capistrano/ops/backup/helper.rb

@@ -5,7 +5,7 @@ module Capistrano
     module Backup
       module Helper
         def backup_file_name(type)
-          regex = type == 'storage' ? "'.{0,}\.tar.gz'" : "'.{0,}\.dump'"
+          regex = type == 'storage' ? "'.{0,}.tar.gz'" : "'.{0,}.dump'"
           @backup_file_name ||= capture "cd #{shared_path}/backups && ls -lt | grep -E -i #{regex} | head -n 1 | awk '{print $9}'"
         end
 
@@ -26,7 +26,7 @@ module Capistrano
           puts 'Temporary backup deleted'
         end
 
-        def question(question, default = 'n', &block)
+        def question(question, default = 'n', &)
           print "#{question} #{default.downcase == 'n' ? '(y/N)' : '(Y/n)'}: "
           input = $stdin.gets.strip.downcase
           answer = (input.empty? ? default : input).downcase.to_s
@@ -34,7 +34,7 @@ module Capistrano
           if %w[y n].include?(answer)
             yield(answer == 'y')
           else
-            question(question, default, &block)
+            question(question, default, &)
           end
         end
 
@@ -47,7 +47,7 @@ module Capistrano
         def size_str(size)
           units = %w[B KB MB GB TB]
           e = (Math.log(size) / Math.log(1024)).floor
-          s = format('%.2f', size.to_f / 1024**e)
+          s = format('%.2f', size.to_f / (1024**e))
           s.sub(/\.?0*$/, units[e])
         end
       end

data/lib/capistrano/ops/backup/tasks/database/create.rake

@@ -3,6 +3,7 @@
 namespace :backup do
   namespace :database do
     include Capistrano::Ops::Backup::Helper
+
     # Default to :app role
     rake_roles = fetch(:rake_roles, :app)
 

data/lib/capistrano/ops/backup/tasks/database/pull.rake

@@ -3,6 +3,7 @@
 namespace :backup do
   namespace :database do
     include Capistrano::Ops::Backup::Helper
+
     # Default to :app role
     rake_roles = fetch(:rake_roles, :app)
 

data/lib/capistrano/ops/backup/tasks/storage/create.rake

@@ -3,6 +3,7 @@
 namespace :backup do
   namespace :storage do
     include Capistrano::Ops::Backup::Helper
+
     # Default to :app role
     rake_roles = fetch(:rake_roles, :app)
 

data/lib/capistrano/ops/backup/tasks/storage/pull.rake

@@ -3,6 +3,7 @@
 namespace :backup do
   namespace :storage do
     include Capistrano::Ops::Backup::Helper
+
     # Default to :app role
     rake_roles = fetch(:rake_roles, :app)
     desc 'pull latest storage dump from server to local'

data/lib/capistrano/ops/figaro_yml/helpers.rb

@@ -2,7 +2,7 @@
 
 require 'yaml'
 
-# rubocop:disable Metrics/ModuleLength
+# rubocop:disable-next Metrics/ModuleLength
 module Capistrano
   module Ops
     module FigaroYml
@@ -63,7 +63,7 @@ module Capistrano
         end
 
         def local_yaml
-          YAML.safe_load(File.read(figaro_yml_local_path)) || {}
+          YAML.safe_load_file(figaro_yml_local_path) || {}
         end
 
         def figaro_yml_env
@@ -162,9 +162,7 @@ module Capistrano
 
         # file helpers
         def write_to_file(file, content)
-          File.open(file, 'w') do |f|
-            f.write(content)
-          end
+          File.write(file, content)
         end
 
         def write_combined_yaml(yamls_combined)
@@ -180,4 +178,3 @@ module Capistrano
     end
   end
 end
-# rubocop:enable Metrics/ModuleLength

data/lib/capistrano/ops/figaro_yml/tasks/check.rake

@@ -3,6 +3,7 @@
 namespace :figaro_yml do
   include Capistrano::Ops::FigaroYml::Paths
   include Capistrano::Ops::FigaroYml::Helpers
+
   desc 'figaro `application.yml` file checks'
   task :check do
     invoke 'figaro_yml:check_figaro_file_exists'

data/lib/capistrano/ops/figaro_yml/tasks/check_config_present.rake

@@ -3,6 +3,7 @@
 namespace :figaro_yml do
   include Capistrano::Ops::FigaroYml::Paths
   include Capistrano::Ops::FigaroYml::Helpers
+
   task :check_config_present do
     next unless local_figaro_yml(figaro_yml_env).nil?
 

data/lib/capistrano/ops/figaro_yml/tasks/check_figaro_file_exists.rake

@@ -3,6 +3,7 @@
 namespace :figaro_yml do
   include Capistrano::Ops::FigaroYml::Paths
   include Capistrano::Ops::FigaroYml::Helpers
+
   task :check_figaro_file_exists do
     next if File.exist?(figaro_yml_local_path)
 

data/lib/capistrano/ops/figaro_yml/tasks/check_git_tracking.rake

@@ -3,6 +3,7 @@
 namespace :figaro_yml do
   include Capistrano::Ops::FigaroYml::Paths
   include Capistrano::Ops::FigaroYml::Helpers
+
   task :check_git_tracking do
     next unless system("git ls-files #{fetch(:figaro_yml_local_path)} --error-unmatch >/dev/null 2>&1")
 

data/lib/capistrano/ops/figaro_yml/tasks/create_local.rake

@@ -3,6 +3,7 @@
 namespace :figaro_yml do
   include Capistrano::Ops::FigaroYml::Paths
   include Capistrano::Ops::FigaroYml::Helpers
+
   task :create_local do
     run_locally do
       puts "found #{stages.count} stages"

data/lib/capistrano/ops/figaro_yml/tasks/figaro_yml_symlink.rake

@@ -3,6 +3,7 @@
 namespace :figaro_yml do
   include Capistrano::Ops::FigaroYml::Paths
   include Capistrano::Ops::FigaroYml::Helpers
+
   task :figaro_yml_symlink do
     set :linked_files, fetch(:linked_files, []).push(fetch(:figaro_yml_remote_path))
   end

data/lib/capistrano/ops/figaro_yml/tasks/get.rake

@@ -3,10 +3,9 @@
 namespace :figaro_yml do
   include Capistrano::Ops::FigaroYml::Paths
   include Capistrano::Ops::FigaroYml::Helpers
+
   task :get do
-    if !File.exist?(figaro_yml_local_path)
-      invoke 'figaro_yml:create_local'
-    else
+    if File.exist?(figaro_yml_local_path)
       local_yml = local_figaro_yml(figaro_yml_env)
       local_global, local_stage, local_rest = configs(local_yml, figaro_yml_env)
       on release_roles :all do
@@ -40,6 +39,8 @@ namespace :figaro_yml do
         # write to new file
         write_combined_yaml(composed_yml.sort.to_h)
       end
+    else
+      invoke 'figaro_yml:create_local'
     end
   end
 end

data/lib/capistrano/ops/figaro_yml/tasks/get_stage.rake

@@ -3,6 +3,7 @@
 namespace :figaro_yml do
   include Capistrano::Ops::FigaroYml::Paths
   include Capistrano::Ops::FigaroYml::Helpers
+
   rake_roles = fetch(:rake_roles, :app)
 
   task :get_stage do

data/lib/capistrano/ops/figaro_yml/tasks/sort_local.rake

@@ -3,6 +3,7 @@
 namespace :figaro_yml do
   include Capistrano::Ops::FigaroYml::Paths
   include Capistrano::Ops::FigaroYml::Helpers
+
   task :sort_local do
     run_locally do
       info 'Sorting local application.yml...'

data/lib/capistrano/ops/figaro_yml.rb

@@ -4,4 +4,5 @@ require 'capistrano/ops/task_loader'
 require 'capistrano/ops/figaro_yml/paths'
 require 'capistrano/ops/figaro_yml/helpers'
 
-TaskLoader.load_tasks_if_gem_present('figaro', 'figaro_yml/tasks', 'WARNING: Gemfile does not include figaro gem which is required for figaro_yml tasks')
+TaskLoader.load_tasks_if_gem_present('figaro', 'figaro_yml/tasks',
+                                     'WARNING: Gemfile does not include figaro gem which is required for figaro_yml tasks')

data/lib/capistrano/ops/invoke/tasks/invoke.rake

@@ -6,7 +6,7 @@ namespace :invoke do
 
   desc 'Execute a rake task on a remote server (cap invoke:rake TASK=db:migrate)'
   task :rake do
-    task_name = ENV['TASK']
+    task_name = ENV.fetch('TASK', nil)
     unless task_name
       puts "\n\nFailed! You need to specify the 'TASK' parameter!",
            'Usage: cap <stage> invoke:rake TASK=your:task',

data/lib/capistrano/ops/logrotate/paths.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'pathname'
 
 module Capistrano

data/lib/capistrano/ops/logrotate/tasks/disable.rake

@@ -3,6 +3,7 @@
 namespace :logrotate do
   include Capistrano::Ops::Logrotate::Paths
   include Capistrano::Ops::Logrotate::Helpers
+
   desc 'disable logrotate'
   task :disable do
     on roles(:app) do

data/lib/capistrano/ops/logrotate.rb

@@ -4,4 +4,5 @@ require 'capistrano/ops/task_loader'
 require 'capistrano/ops/logrotate/helpers'
 require 'capistrano/ops/logrotate/paths'
 
-TaskLoader.load_tasks_if_gem_present('whenever', 'logrotate/tasks', 'WARNING: Gemfile does not include whenever gem which is required for logrotate tasks')
+TaskLoader.load_tasks_if_gem_present('whenever', 'logrotate/tasks',
+                                     'WARNING: Gemfile does not include whenever gem which is required for logrotate tasks')

data/lib/capistrano/ops/rails/lib/backup/api.rb

@@ -4,7 +4,7 @@ module Backup
   class Api
     attr_accessor :backup_provider, :provider_config
 
-    def initialize(provider: ENV['BACKUP_PROVIDER'], provider_config: {})
+    def initialize(provider: ENV.fetch('BACKUP_PROVIDER', nil), provider_config: {})
       self.backup_provider = provider
       self.provider_config = provider_config
     end

data/lib/capistrano/ops/rails/lib/backup/s3.rb

@@ -12,8 +12,9 @@ module Backup
 
     attr_accessor :endpoint, :region, :access_key_id, :secret_access_key, :s3_resource, :s3_client
 
-    def initialize(endpoint: ENV['S3_BACKUP_ENDPOINT'], region: ENV['S3_BACKUP_REGION'], access_key_id: ENV['S3_BACKUP_KEY'],
-                   secret_access_key: ENV['S3_BACKUP_SECRET'])
+    def initialize(endpoint: ENV.fetch('S3_BACKUP_ENDPOINT',
+                                       nil), region: ENV.fetch('S3_BACKUP_REGION', nil), access_key_id: ENV.fetch('S3_BACKUP_KEY', nil),
+                   secret_access_key: ENV.fetch('S3_BACKUP_SECRET', nil))
       self.endpoint = endpoint
       self.region = region
       self.access_key_id = access_key_id
@@ -31,7 +32,7 @@ module Backup
 
     def upload(backup_file, key)
       begin
-        s3_resource.bucket(ENV['S3_BACKUP_BUCKET']).object(key).upload_file(backup_file)
+        s3_resource.bucket(ENV.fetch('S3_BACKUP_BUCKET', nil)).object(key).upload_file(backup_file)
       rescue Backup::Error => e
         puts "Upload failed: #{e.message}"
         raise e
@@ -49,7 +50,7 @@ module Backup
 
     # rubocop:disable Metrics/MethodLength
     def upload_file_as_stream(file_path, key)
-      bucket = ENV['S3_BACKUP_BUCKET']
+      bucket = ENV.fetch('S3_BACKUP_BUCKET', nil)
       # Calculate total size of the file to be uploaded
       total_size = File.size(file_path)
       chunk_size = calculate_chunk_size(total_size)
@@ -130,7 +131,7 @@ module Backup
     end
 
     def upload_folder_as_tar_gz_stream(folder_path, key)
-      bucket = ENV['S3_BACKUP_BUCKET']
+      bucket = ENV.fetch('S3_BACKUP_BUCKET', nil)
 
       # Calculate total size of the files to be uploaded
       total_size = calculate_total_size(folder_path)
@@ -256,7 +257,7 @@ module Backup
     end
 
     def remove_old_backups(basename, keep: 5)
-      all_items = s3_resource.bucket(ENV['S3_BACKUP_BUCKET']).objects(prefix: basename).map do |item|
+      all_items = s3_resource.bucket(ENV.fetch('S3_BACKUP_BUCKET', nil)).objects(prefix: basename).map do |item|
         { key: item.key, last_modified: item.last_modified }
       end
 
@@ -272,7 +273,7 @@ module Backup
           puts "Removing #{month} from S3"
           delete_items.each do |item_obj|
             puts "Removing #{item_obj[:key]} from S3"
-            s3_resource.bucket(ENV['S3_BACKUP_BUCKET']).object(item_obj[:key]).delete
+            s3_resource.bucket(ENV.fetch('S3_BACKUP_BUCKET', nil)).object(item_obj[:key]).delete
           end
         end
         puts 'Old months removed from S3'
@@ -286,7 +287,7 @@ module Backup
 
       current_month_delete_items.each do |item_obj|
         puts "Removing #{item_obj[:key]} from S3"
-        s3_resource.bucket(ENV['S3_BACKUP_BUCKET']).object(item_obj[:key]).delete
+        s3_resource.bucket(ENV.fetch('S3_BACKUP_BUCKET', nil)).object(item_obj[:key]).delete
       end
       puts 'Old backups removed from S3'
     rescue Backup::Error => e

data/lib/capistrano/ops/rails/lib/backup.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'capistrano/ops/rails/lib/backup/api'
 require 'capistrano/ops/rails/lib/backup/s3'
 

data/lib/capistrano/ops/rails/lib/notification/api.rb

@@ -4,7 +4,7 @@ module Notification
   class Api
     attr_accessor :notification_type, :notification_level
 
-    def initialize(notification_type: ENV['NOTIFICATION_TYPE'], notification_level: ENV['NOTIFICATION_LEVEL'])
+    def initialize(notification_type: ENV.fetch('NOTIFICATION_TYPE', nil), notification_level: ENV.fetch('NOTIFICATION_LEVEL', nil))
       self.notification_type = notification_type
       self.notification_level = notification_level || 'error'
     end

data/lib/capistrano/ops/rails/lib/notification/slack.rb

@@ -6,8 +6,8 @@ require 'json'
 module Notification
   class Slack
     def initialize
-      @slack_secret = ENV['SLACK_SECRET']
-      @slack_channel = ENV['SLACK_CHANNEL']
+      @slack_secret = ENV.fetch('SLACK_SECRET', nil)
+      @slack_channel = ENV.fetch('SLACK_CHANNEL', nil)
       @conn = Faraday.new(url: 'https://slack.com/api/') do |faraday|
         faraday.headers['Content-Type'] = 'application/json'
         faraday.headers['Authorization'] = "Bearer #{@slack_secret}"
@@ -20,8 +20,8 @@ module Notification
       begin
         res = @conn.post('chat.postMessage') do |req|
           req.body = {
-            "channel": @slack_channel,
-            "text": message
+            channel: @slack_channel,
+            text: message
           }.to_json
         end
         response = JSON.parse(res.body)

data/lib/capistrano/ops/rails/lib/notification/webhook.rb

@@ -7,18 +7,18 @@ module Notification
     require 'json'
 
     def initialize
-      @webhook_url = ENV['WEBHOOK_URL']
-      @secret = ENV['WEBHOOK_SECRET']
+      @webhook_url = ENV.fetch('WEBHOOK_URL', nil)
+      @secret = ENV.fetch('WEBHOOK_SECRET', nil)
       @conn = Faraday.new(url: @webhook_url) do |faraday|
         faraday.headers['Content-Type'] = 'application/json'
       end
     end
 
     def generate_signature(payload_body)
-      "md5=#{OpenSSL::HMAC.hexdigest('md5', ENV['WEBHOOK_SECRET'], payload_body)}"
+      "md5=#{OpenSSL::HMAC.hexdigest('md5', ENV.fetch('WEBHOOK_SECRET', nil), payload_body)}"
     end
 
-    def backup_notification(result, webhook_data, _notification_level)
+    def backup_notification(result, webhook_data, notification_level)
       return if @webhook_url.nil? || @secret.nil?
       return if result && notification_level == 'error'
 

data/lib/capistrano/ops/rails/lib/tasks/pg/dump.rake

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require_relative './postgres_helper'
+require_relative 'postgres_helper'
 namespace :pg do
   include PostgresHelper
 
@@ -25,11 +25,11 @@ namespace :pg do
     result = system(commandlist)
 
     if ENV['BACKUP_PROVIDER'].present? && external_backup && result
-      puts "Uploading #{filename} to #{ENV['BACKUP_PROVIDER']}..."
+      puts "Uploading #{filename} to #{ENV.fetch('BACKUP_PROVIDER', nil)}..."
       provider = Backup::Api.new
       begin
         provider.upload("#{backup_path}/#{filename}", filename.to_s, 'file')
-        puts "#{filename} uploaded to #{ENV['BACKUP_PROVIDER']}"
+        puts "#{filename} uploaded to #{ENV.fetch('BACKUP_PROVIDER', nil)}"
       rescue StandardError => e
         puts "#{filename} upload failed: #{e.message}"
       end

data/lib/capistrano/ops/rails/lib/tasks/pg/postgres_helper.rb

@@ -27,7 +27,7 @@ module PostgresHelper
     messages = []
     if result
       messages << "Backup of #{database} successfully finished at #{Time.now}"
-      messages << "Backup path:\`#{backup_path}/#{filename}\`"
+      messages << "Backup path:`#{backup_path}/#{filename}`"
     else
       messages << "Backup of #{database} failed at #{Time.now}"
     end
@@ -54,14 +54,14 @@ module PostgresHelper
     commandlist = []
     commandlist << "export PGPASSWORD='#{password}'"
     commandlist << "cd #{backup_path}"
-    commandlist << "pg_dump --no-acl --no-owner #{options.join('')} > #{filename}"
+    commandlist << "pg_dump --no-acl --no-owner #{options.join} > #{filename}"
     commandlist.join(' && ')
   end
 
   def size_str(size)
     units = %w[B KB MB GB TB]
     e = (Math.log(size) / Math.log(1024)).floor
-    s = format('%.2f', size.to_f / 1024**e)
+    s = format('%.2f', size.to_f / (1024**e))
     s.sub(/\.?0*$/, units[e])
   end
 end

data/lib/capistrano/ops/rails/lib/tasks/pg/remove_old_dumps.rake

@@ -12,7 +12,7 @@ namespace :pg do
   external_backup = Rails.env.production? || ENV['EXTERNAL_BACKUP_ENABLED'] == 'true'
 
   task :remove_old_dumps do
-    bash_regex = "'#{@database}.{0,}\.dump'"
+    bash_regex = "'#{@database}.{0,}.dump'"
 
     unless backups_enabled
       puts 'remove_old_dumps: Backups are disabled'

data/lib/capistrano/ops/rails/lib/tasks/storage/backup.rake

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require_relative './storage_helper'
+require_relative 'storage_helper'
 namespace :storage do
   include StorageHelper
 

data/lib/capistrano/ops/rails/lib/tasks/storage/remove_old_backups.rake

@@ -14,7 +14,7 @@ namespace :storage do
   @total_external_backups_no = (@env_external_no || ENV['NUMBER_OF_BACKUPS'] || 7).to_i
   desc 'remove old storage backups'
   task :remove_old_backups do
-    bash_regex = "'storage_.{0,}\.tar.gz'"
+    bash_regex = "'storage_.{0,}.tar.gz'"
 
     unless backups_enabled
       puts 'remove_old_backups: Backups are disabled'
@@ -37,7 +37,7 @@ namespace :storage do
       'xargs rm -rf'
     ]
 
-    result = system(commandlist.join(' | ')) if @total_local_backups_no.positive? && local_backup || !local_backup && external_backup
+    result = system(commandlist.join(' | ')) if (@total_local_backups_no.positive? && local_backup) || (!local_backup && external_backup)
     puts 'remove_old_backups: local cleanup finished' if result
 
     if ENV['BACKUP_PROVIDER'].present? && external_backup

data/lib/capistrano/ops/rails/lib/tasks/storage/storage_helper.rb

@@ -9,7 +9,7 @@ module StorageHelper
         backups_enabled: env_or_production('BACKUPS_ENABLED'),
         external_backup: env_or_production('EXTERNAL_BACKUP_ENABLED'),
         keep_local_backups: env_or_production('KEEP_LOCAL_STORAGE_BACKUPS'),
-        backup_provider: ENV['BACKUP_PROVIDER']
+        backup_provider: ENV.fetch('BACKUP_PROVIDER', nil)
       }
   end
 
@@ -23,7 +23,7 @@ module StorageHelper
     messages = []
     if result
       messages << "Backup of storage folder successfully finished at #{Time.now}"
-      messages << "Backup path:\`#{@backup_path}/#{@filename}\`"
+      messages << "Backup path:`#{@backup_path}/#{@filename}`"
     else
       messages << "Backup of storage folder failed at #{Time.now}"
     end
@@ -34,19 +34,19 @@ module StorageHelper
     @backup_path = settings[:backup_path]
     @date = Time.now.to_i
     @filename = "storage_#{@date}.tar.gz"
-    FileUtils.mkdir_p(@backup_path) unless Dir.exist?(@backup_path)
+    FileUtils.mkdir_p(@backup_path)
     "tar -zcf #{@backup_path}/#{@filename} -C #{settings[:storage_path]} ."
   end
 
   def size_str(size)
     units = %w[B KB MB GB TB]
     e = (Math.log(size) / Math.log(1024)).floor
-    s = format('%.2f', size.to_f / 1024**e)
+    s = format('%.2f', size.to_f / (1024**e))
     s.sub(/\.?0*$/, units[e])
   end
 
   def create_local_backup(filename, storage_path, backup_path)
-    FileUtils.mkdir_p(backup_path) unless Dir.exist?(backup_path)
+    FileUtils.mkdir_p(backup_path)
     response = system(backup_cmd(backup_path: backup_path, storage_path: storage_path))
     FileUtils.rm_rf("#{@backup_path}/#{filename}") unless response
     puts response ? "Backup created: #{backup_path}/#{@filename} (#{size_str(File.size("#{@backup_path}/#{@filename}"))})" : 'Backup failed removing dump file'

data/lib/capistrano/ops/version.rb

@@ -2,6 +2,6 @@
 
 module Capistrano
   module Ops
-    VERSION = '1.0.11'
+    VERSION = '1.1.0'
   end
 end

data/lib/capistrano/ops/whenever.rb

@@ -2,4 +2,5 @@
 
 require 'capistrano/ops/task_loader'
 
-TaskLoader.load_tasks_if_gem_present('whenever', 'whenever/tasks', 'WARNING: Gemfile does not include whenever gem which is required for whenever tasks')
+TaskLoader.load_tasks_if_gem_present('whenever', 'whenever/tasks',
+                                     'WARNING: Gemfile does not include whenever gem which is required for whenever tasks')

data/lib/capistrano/ops/wkhtmltopdf/tasks/setup.rake

@@ -2,6 +2,7 @@
 
 namespace :wkhtmltopdf do
   include Capistrano::Ops::Wkhtmltopdf::Helpers
+
   after 'deploy:symlink:release', 'wkhtmltopdf:setup'
 
   desc 'unzip wkhtmltopdf if necessary'

data/spec/capistrano/ops/version_spec.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe Capistrano::Ops do
+  it 'has a version number' do
+    expect(Capistrano::Ops::VERSION).to match(/\A\d+\.\d+\.\d+\z/)
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+require 'capistrano/ops/version'
+
+RSpec.configure do |config|
+  config.expect_with :rspec do |expectations|
+    expectations.include_chain_clauses_in_custom_matcher_descriptions = true
+  end
+
+  config.mock_with :rspec do |mocks|
+    mocks.verify_partial_doubles = true
+  end
+
+  config.shared_context_metadata_behavior = :apply_to_host_groups
+  config.disable_monkey_patching!
+  config.warnings = false
+  config.default_formatter = 'doc' if config.files_to_run.one?
+  config.order = :random
+  Kernel.srand config.seed
+end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: capistrano-ops
 version: !ruby/object:Gem::Version
-  version: 1.0.11
+  version: 1.1.0
 platform: ruby
 authors:
 - Florian Crusius
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-12-22 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-s3
@@ -30,56 +29,88 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3.0'
 - !ruby/object:Gem::Dependency
   name: nokogiri
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.15'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.15'
 - !ruby/object:Gem::Dependency
   name: rails
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '7.2'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '7.2'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
 - !ruby/object:Gem::Dependency
   name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.4'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.4'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '5'
+- !ruby/object:Gem::Dependency
+  name: bundler-audit
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '0.9'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '0.9'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -114,42 +145,42 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '1.80'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '1.80'
 - !ruby/object:Gem::Dependency
   name: rubocop-rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.6'
+        version: '0.7'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.6'
+        version: '0.7'
 - !ruby/object:Gem::Dependency
   name: rubocop-rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '3.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '3.0'
 description: A collection of devops tasks for rails applications
 email:
 - florian@zauberware.com
@@ -159,11 +190,14 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- ".github/dependabot.yml"
+- ".github/workflows/ci.yml"
 - ".github/workflows/release.yml"
 - ".gitignore"
+- ".rspec"
 - ".rubocop.yml"
+- ".rubocop_todo.yml"
 - ".ruby-version"
-- ".travis.yml"
 - CHANGELOG.md
 - Gemfile
 - LICENSE.txt
@@ -180,7 +214,6 @@ files:
 - lib/capistrano/ops/backup/tasks/storage/create.rake
 - lib/capistrano/ops/backup/tasks/storage/pull.rake
 - lib/capistrano/ops/capistrano.rb
-- lib/capistrano/ops/capistrano/v3/tasks/backup.rake
 - lib/capistrano/ops/figaro_yml.rb
 - lib/capistrano/ops/figaro_yml/helpers.rb
 - lib/capistrano/ops/figaro_yml/paths.rb
@@ -239,11 +272,13 @@ files:
 - lib/capistrano/ops/wkhtmltopdf/helpers.rb
 - lib/capistrano/ops/wkhtmltopdf/tasks/setup.rake
 - scripts/bump_version.rb
+- spec/capistrano/ops/version_spec.rb
+- spec/spec_helper.rb
 homepage: https://github.com/zauberware/capistrano-ops
 licenses:
 - MIT
-metadata: {}
-post_install_message:
+metadata:
+  rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths:
 - lib
@@ -251,18 +286,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.1.4
-  - - "<"
-    - !ruby/object:Gem::Version
-      version: 3.4.0
+      version: '3.2'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.22
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
 summary: devops tasks for rails applications
 test_files: []

data/.travis.yml

@@ -1,13 +0,0 @@
-language: ruby
-
-before_install: gem install bundler
-
-rvm:
-  - 2.4.6
-  - 2.5.5
-  - 2.6.3
-  - jruby-9.2.6.0
-
-env:
-  global:
-    - JRUBY_OPTS=--debug

data/lib/capistrano/ops/capistrano/v3/tasks/backup.rake

@@ -1,25 +0,0 @@
-# frozen_string_literal: true
-
-require_relative 'backup/backup_helper'
-
-namespace :backup do
-  include BackupHelper
-  # Default to :app role
-  rake_roles = fetch(:rake_roles, :app)
-
-  desc 'create a backup of the server database (deprecated, use backup:database:create instead)'
-  task :create do
-    on roles(rake_roles) do
-      warn "deprecated: use 'backup:database:create' instead, in future versions this task will be removed"
-      execute "#{prepare_env} BACKUPS_ENABLED=true EXTERNAL_BACKUP_ENABLED=false bundle exec rake pg:dump"
-    end
-  end
-  desc 'pull latest database backups from server to local (deprecated, use backup:database:pull instead)'
-  task :pull do
-    on roles(rake_roles) do
-      warn "deprecated: use 'backup:database:pull' instead, in future versions this task will be removed"
-      backup_file = backup_file_name('database')
-      download! "#{shared_path}/backups/#{backup_file}", backup_file
-    end
-  end
-end