ruborg 0.8.1 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 74bbfee5ede7b87c5a99ddec057c90430ee66a5667e6a933455baf4478f569d2
-  data.tar.gz: f7ddb9aa319573d39888fad0933de0ce99fcc08069eae459550605eba9ff1082
+  metadata.gz: a4d69dff5edaf281b1014e64653462df7d7af84be0f341db0c4fe389978f25b1
+  data.tar.gz: b206422e04dab022cd19a8d4ea6f9bd399988fc27b6e810fd673dfb7de0fb9ba
 SHA512:
-  metadata.gz: 285d04844f53fc87e5af8b28d24fc9dfe410e1610e2c79845ea0b1a5ea8a7d60ed76c5df2f667068b0c2b55269870d9af2c30f64ed9f8efc63312d1f99acd60a
-  data.tar.gz: e72be5e589955c1e3832a5f38236d485d61db23a8f60ece3a147a6ecf21eb1b66fd9e1eddbc77c4720c4dc69f675491eb4c7eb5dc22b93b2a1856757af4e7a96
+  metadata.gz: f881b5b0908afaa16729339263d1584d861cd3a3d6b613599cbdb120340a86a2dc69408dc3f630d347769b990ea6c36ced1b538d17ba1517bebfb347c5c9ef2b
+  data.tar.gz: ffd3ee5bd76b08ac9753d66ae95ac1aebaed2f4ba6db38ddc720e013970d2799a99202e4cf7295f969dd93ddf4f8b8b7df6d8730352a33f8ff86ce76eecbaff6

data/CHANGELOG.md

@@ -7,6 +7,39 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.9.0] - 2025-10-14
+
+### Changed
+- **Command Consolidation**: Unified validation commands for consistency
+  - `ruborg validate` renamed to `ruborg validate config` (validates YAML configuration)
+  - `ruborg check` renamed to `ruborg validate repo` (validates repository compatibility and integrity)
+  - Both commands now use consistent `validate` terminology
+  - `--verify-data` option remains available for `validate repo` to run full integrity checks
+  - Eliminates confusion between `validate` (config) and `check` (repository)
+  - Updated README with new command syntax and examples
+  - Updated all tests to use new command format
+
+### Added
+- **Skip Hash Check Option**: New `skip_hash_check` configuration option for faster per-file backups
+  - Skips expensive SHA256 content hash calculation when file already exists
+  - Trusts file path, size, and modification time matching for duplicate detection
+  - Significantly speeds up backups with many unchanged files
+  - Configurable globally or per-repository
+  - Default: `false` (paranoid mode - always verify content hash)
+  - Use case: Large directories where mtime changes are reliable (most filesystems)
+  - Example: `skip_hash_check: true` in YAML configuration
+- **Migration Help**: `ruborg check` now displays a helpful deprecation notice
+  - Shows clear message explaining the command has been renamed
+  - Provides examples of the new `ruborg validate repo` syntax
+  - Exits with error to prevent confusion
+  - Logs deprecation warning for audit trail
+- **Enhanced Version Command**: `ruborg version` now shows both Ruborg and Borg versions with path
+  - Displays Ruborg version (gem version)
+  - Displays installed Borg version and executable path
+  - Example output: `borg 1.2.8 (/usr/local/bin/borg)`
+  - Gracefully handles missing Borg installation
+  - Helps users verify both tool versions and location at a glance
+
 ## [0.8.1] - 2025-10-09
 
 ### Added

data/README.md

@@ -25,7 +25,7 @@ A friendly Ruby frontend for [Borg Backup](https://www.borgbackup.org/). Ruborg
 - 📈 **Summary View** - Quick overview of all repositories and their configurations
 - 🔧 **Custom Borg Path** - Support for custom Borg executable paths per repository
 - 🏠 **Hostname Validation** - NEW! Restrict backups to specific hosts (global or per-repository)
-- ✅ **Well-tested** - Comprehensive test suite with RSpec (294 examples, 0 failures)
+- ✅ **Well-tested** - Comprehensive test suite with RSpec (297 examples, 0 failures)
 - 🔒 **Security-focused** - Path validation, safe YAML loading, command injection protection
 
 ## Prerequisites
@@ -163,13 +163,14 @@ repositories:
 
 **Configuration Features:**
 - **Automatic Type Validation**: Configuration is validated on startup to catch type errors early
-- **Validation Command**: Run `ruborg validate` to check configuration files for errors
+- **Validation Command**: Run `ruborg validate config` to check configuration files for errors
 - **Descriptions**: Add `description` field to document each repository's purpose
 - **Hostname Validation**: Optional `hostname` field to restrict backups to specific hosts (global or per-repository)
 - **Source Deletion Safety**: `allow_remove_source` flag to explicitly enable `--remove-source` option (default: disabled)
+- **Skip Hash Check**: Optional `skip_hash_check` flag to skip content hash verification for faster backups (per-file mode only)
 - **Type-Safe Booleans**: Strict boolean validation prevents configuration errors (must use `true`/`false`, not strings)
-- **Global Settings**: Hostname, compression, encryption, auto_init, allow_remove_source, log_file, borg_path, borg_options, and retention apply to all repositories
-- **Per-Repository Overrides**: Any global setting can be overridden at the repository level (including hostname, allow_remove_source, and custom borg_path)
+- **Global Settings**: Hostname, compression, encryption, auto_init, allow_remove_source, skip_hash_check, log_file, borg_path, borg_options, and retention apply to all repositories
+- **Per-Repository Overrides**: Any global setting can be overridden at the repository level (including hostname, allow_remove_source, skip_hash_check, and custom borg_path)
 - **Custom Borg Path**: Specify a custom Borg executable path if borg is not in PATH or to use a specific version
 - **Retention Policies**: Define how many backups to keep (hourly, daily, weekly, monthly, yearly)
 - **Multiple Sources**: Each repository can have multiple backup sources with their own exclude patterns
@@ -184,7 +185,7 @@ Ruborg automatically validates your configuration on startup. All commands check
 Check your configuration file for errors:
 
 ```bash
-ruborg validate --config ruborg.yml
+ruborg validate config --config ruborg.yml
 ```
 
 **Validation checks:**
@@ -471,20 +472,20 @@ Group: postgres
 Type: regular file
 ```
 
-### Check Repository Compatibility
+### Validate Repository Compatibility
 
 ```bash
 # Check specific repository compatibility with installed Borg version
-ruborg check --repository documents
+ruborg validate repo --repository documents
 
 # Check all repositories
-ruborg check --all
+ruborg validate repo --all
 
 # Check with data integrity verification (slower)
-ruborg check --repository documents --verify-data
+ruborg validate repo --repository documents --verify-data
 ```
 
-The `check` command verifies:
+The `validate repo` command verifies:
 - Installed Borg version
 - Repository format version
 - Compatibility between Borg and repository versions
@@ -494,11 +495,11 @@ The `check` command verifies:
 ```
 Borg version: 1.2.8
 
---- Checking repository: documents ---
+--- Validating repository: documents ---
   Repository version: 1
   ✓ Compatible with Borg 1.2.8
 
---- Checking repository: databases ---
+--- Validating repository: databases ---
   Repository version: 2
   ✗ INCOMPATIBLE with Borg 1.2.8
     Repository version 2 cannot be read by Borg 1.2.8
@@ -652,26 +653,26 @@ See [SECURITY.md](SECURITY.md) for detailed security information and best practi
 | Command | Description | Options |
 |---------|-------------|---------|
 | `init REPOSITORY` | Initialize a new Borg repository | `--passphrase`, `--passbolt-id`, `--log` |
-| `validate` | Validate configuration file for type errors | `--config`, `--log` |
+| `validate config` | Validate configuration file for type errors | `--config`, `--log` |
+| `validate repo` | Validate repository compatibility and integrity | `--config`, `--repository`, `--all`, `--verify-data`, `--log` |
 | `backup` | Create a backup using config file | `--config`, `--repository`, `--all`, `--name`, `--remove-source`, `--log` |
 | `list` | List archives or files in repository | `--config`, `--repository`, `--archive`, `--log` |
 | `restore ARCHIVE` | Restore files from archive | `--config`, `--repository`, `--destination`, `--path`, `--log` |
 | `metadata ARCHIVE` | Get file metadata from archive | `--config`, `--repository`, `--file`, `--log` |
 | `info` | Show repository information | `--config`, `--repository`, `--log` |
-| `check` | Check repository integrity and compatibility | `--config`, `--repository`, `--all`, `--verify-data`, `--log` |
 | `version` | Show ruborg version | None |
 
 ### Options
 
 - `--config`: Path to configuration file (default: `ruborg.yml`)
 - `--log`: Path to log file (overrides config, default: `~/.ruborg/logs/ruborg.log`)
-- `--repository` / `-r`: Repository name (optional for info, required for backup/list/restore/check unless --all)
-- `--all`: Process all repositories (backup and check commands)
+- `--repository` / `-r`: Repository name (optional for info, required for backup/list/restore/validate repo unless --all)
+- `--all`: Process all repositories (backup and validate repo commands)
 - `--name`: Custom archive name (backup command only)
 - `--remove-source`: Remove source files after successful backup (backup command only)
 - `--destination`: Destination directory for restore (restore command only)
 - `--path`: Specific file or directory to restore (restore command only)
-- `--verify-data`: Run full data integrity check (check command only, slower)
+- `--verify-data`: Run full data integrity check (validate repo command only, slower)
 
 ## Retention Policies
 
@@ -822,6 +823,60 @@ repositories:
 
 **Backup vs Retention:** The per-file `retention_mode` only affects how archives are created and pruned. Traditional backup commands still work normally - you can list, restore, and check per-file archives just like standard archives.
 
+### Skip Hash Check for Faster Backups
+
+**NEW:** In per-file backup mode, you can optionally skip content hash verification for faster duplicate detection:
+
+```yaml
+repositories:
+  - name: project-files
+    path: /mnt/backup/project-files
+    retention_mode: per_file
+    skip_hash_check: true    # Skip SHA256 content hash verification
+    sources:
+      - name: projects
+        paths:
+          - /home/user/projects
+```
+
+**How it works:**
+- **Default (paranoid mode)**: Ruborg calculates SHA256 hash of file content to verify files haven't changed (even when size and mtime are identical)
+- **With skip_hash_check: true**: Ruborg trusts file path, size, and modification time for duplicate detection (skips hash calculation)
+
+**When to use:**
+- ✅ **Large directories** with thousands of files where hash calculation is slow
+- ✅ **Reliable filesystems** where modification time changes are trustworthy
+- ✅ **Regular backups** where files are unlikely to be manually modified with `touch -t`
+
+**When NOT to use:**
+- ❌ **Security-critical data** where you want maximum verification
+- ❌ **Untrusted sources** where files might be tampered with
+- ❌ **Systems with unreliable mtime** (rare, but some network filesystems)
+
+**Performance impact:**
+```yaml
+# Example: 10,000 unchanged files, average 50KB each
+# With skip_hash_check: false (default) - ~30 seconds (read + hash all files)
+# With skip_hash_check: true            - ~3 seconds  (read metadata only)
+```
+
+**Console output:**
+```
+# With skip_hash_check: true
+[1/10000] Backing up: /home/user/file1.txt - Archive already exists (skipped hash check)
+[2/10000] Backing up: /home/user/file2.txt - Archive already exists (skipped hash check)
+...
+✓ Per-file backup completed: 50 file(s) backed up, 9950 skipped (hash check skipped)
+
+# With skip_hash_check: false (default)
+[1/10000] Backing up: /home/user/file1.txt - Archive already exists (file unchanged)
+[2/10000] Backing up: /home/user/file2.txt - Archive already exists (file unchanged)
+...
+✓ Per-file backup completed: 50 file(s) backed up, 9950 skipped (unchanged)
+```
+
+**Security note:** Even with `skip_hash_check: true`, files are still verified by path, size, and mtime. The only difference is skipping the SHA256 content hash verification, which catches rare edge cases like manual file tampering with preserved timestamps.
+
 ### Automatic Pruning
 
 Enable **automatic pruning** to remove old backups after each backup operation:

data/lib/ruborg/backup.rb

@@ -3,12 +3,13 @@
 module Ruborg
   # Backup operations using Borg
   class Backup
-    def initialize(repository, config:, retention_mode: "standard", repo_name: nil, logger: nil)
+    def initialize(repository, config:, retention_mode: "standard", repo_name: nil, logger: nil, skip_hash_check: false)
       @repository = repository
       @config = config
       @retention_mode = retention_mode
       @repo_name = repo_name
       @logger = logger
+      @skip_hash_check = skip_hash_check
     end
 
     def create(name: nil, remove_source: false)
@@ -89,15 +90,13 @@ module Ruborg
             stored_size = stored_info[:size]
 
             if current_size == stored_size
-              # Size same -> verify content hasn't changed (paranoid mode)
-              current_hash = calculate_file_hash(file_path)
-              stored_hash = stored_info[:hash]
-
-              if current_hash == stored_hash
-                # Content truly unchanged - file is already safely backed up
-                puts " - Archive already exists (file unchanged)"
+              # Size same -> verify content hasn't changed (paranoid mode) unless skip_hash_check is enabled
+              if @skip_hash_check
+                # Skip hash check - assume file is unchanged based on size and mtime
+                puts " - Archive already exists (skipped hash check)"
                 @logger&.info(
-                  "[#{@repo_name}] Skipped #{file_path} - archive #{archive_name} already exists (file unchanged)"
+                  "[#{@repo_name}] Skipped #{file_path} - archive #{archive_name} already exists " \
+                  "(hash check skipped)"
                 )
                 skipped_count += 1
 
@@ -106,12 +105,29 @@ module Ruborg
 
                 next
               else
-                # Size same but content changed (rare: edited + truncated/padded to same size)
-                archive_name = find_next_version_name(archive_name, existing_archives)
-                @logger&.warn(
-                  "[#{@repo_name}] File content changed but size/mtime unchanged for #{file_path}, " \
-                  "using #{archive_name}"
-                )
+                current_hash = calculate_file_hash(file_path)
+                stored_hash = stored_info[:hash]
+
+                if current_hash == stored_hash
+                  # Content truly unchanged - file is already safely backed up
+                  puts " - Archive already exists (file unchanged)"
+                  @logger&.info(
+                    "[#{@repo_name}] Skipped #{file_path} - archive #{archive_name} already exists (file unchanged)"
+                  )
+                  skipped_count += 1
+
+                  # If remove_source is enabled, delete the file (it's already safely backed up)
+                  remove_single_file(file_path) if remove_source
+
+                  next
+                else
+                  # Size same but content changed (rare: edited + truncated/padded to same size)
+                  archive_name = find_next_version_name(archive_name, existing_archives)
+                  @logger&.warn(
+                    "[#{@repo_name}] File content changed but size/mtime unchanged for #{file_path}, " \
+                    "using #{archive_name}"
+                  )
+                end
               end
             else
               # Size changed but mtime same -> content changed, add version suffix

data/lib/ruborg/cli.rb

@@ -184,8 +184,23 @@ module Ruborg
       raise
     end
 
-    desc "validate", "Validate configuration file for errors and type issues"
-    def validate_config
+    desc "validate TYPE", "Validate configuration file or repository (TYPE: config or repo)"
+    option :verify_data, type: :boolean, default: false, desc: "Verify repository data (slower, only for 'repo' type)"
+    option :all, type: :boolean, default: false, desc: "Validate all repositories (only for 'repo' type)"
+    def validate(type)
+      case type
+      when "config"
+        validate_config_implementation
+      when "repo"
+        validate_repo_implementation
+      else
+        raise ConfigError, "Invalid validation type: #{type}. Use 'config' or 'repo'"
+      end
+    end
+
+    private
+
+    def validate_config_implementation
       @logger.info("Validating configuration file: #{options[:config]}")
       config = Config.new(options[:config])
 
@@ -201,6 +216,7 @@ module Ruborg
       errors.concat(validate_boolean_setting(global_settings, "auto_init", "global"))
       errors.concat(validate_boolean_setting(global_settings, "auto_prune", "global"))
       errors.concat(validate_boolean_setting(global_settings, "allow_remove_source", "global"))
+      errors.concat(validate_boolean_setting(global_settings, "skip_hash_check", "global"))
 
       # Validate borg_options booleans
       if global_settings["borg_options"]
@@ -214,6 +230,7 @@ module Ruborg
         errors.concat(validate_boolean_setting(repo, "auto_init", repo_name))
         errors.concat(validate_boolean_setting(repo, "auto_prune", repo_name))
         errors.concat(validate_boolean_setting(repo, "allow_remove_source", repo_name))
+        errors.concat(validate_boolean_setting(repo, "skip_hash_check", repo_name))
 
         if repo["borg_options"]
           warnings.concat(validate_borg_option(repo["borg_options"], "allow_relocated_repo", repo_name))
@@ -257,64 +274,8 @@ module Ruborg
       raise
     end
 
-    desc "version", "Show ruborg version"
-    def version
-      require_relative "version"
-      puts "ruborg #{Ruborg::VERSION}"
-      @logger.info("Version checked: #{Ruborg::VERSION}")
-    end
-
-    desc "metadata ARCHIVE", "Get file metadata from an archive"
-    option :file, type: :string, desc: "Specific file path (required for standard archives, auto for per-file)"
-    def metadata(archive_name)
-      @logger.info("Getting metadata for archive: #{archive_name}")
-      config = Config.new(options[:config])
-
-      raise ConfigError, "Please specify --repository" unless options[:repository]
-
-      repo_config = config.get_repository(options[:repository])
-      raise ConfigError, "Repository '#{options[:repository]}' not found" unless repo_config
-
-      global_settings = config.global_settings
-      merged_config = global_settings.merge(repo_config)
-      validate_hostname(merged_config)
-      passphrase = fetch_passphrase_for_repo(merged_config)
-      borg_opts = merged_config["borg_options"] || {}
-      borg_path = merged_config["borg_path"]
-
-      repo = Repository.new(repo_config["path"], passphrase: passphrase, borg_options: borg_opts, borg_path: borg_path,
-                                                 logger: @logger)
-
-      raise BorgError, "Repository does not exist at #{repo_config["path"]}" unless repo.exists?
-
-      # Get file metadata
-      metadata = repo.get_file_metadata(archive_name, file_path: options[:file])
-
-      # Display metadata
-      puts "\n═══════════════════════════════════════════════════════════════"
-      puts "  FILE METADATA"
-      puts "═══════════════════════════════════════════════════════════════\n\n"
-      puts "Archive: #{archive_name}"
-      puts "File: #{metadata["path"]}"
-      puts "Size: #{format_size(metadata["size"])}"
-      puts "Modified: #{metadata["mtime"]}"
-      puts "Mode: #{metadata["mode"]}"
-      puts "User: #{metadata["user"]}"
-      puts "Group: #{metadata["group"]}"
-      puts "Type: #{metadata["type"]}"
-      puts ""
-
-      @logger.info("Successfully retrieved metadata for #{metadata["path"]}")
-    rescue Error => e
-      @logger.error("Failed to get metadata: #{e.message}")
-      raise
-    end
-
-    desc "check", "Check repository integrity and compatibility"
-    option :verify_data, type: :boolean, default: false, desc: "Verify repository data (slower)"
-    option :all, type: :boolean, default: false, desc: "Check all repositories"
-    def check
-      @logger.info("Checking repository compatibility")
+    def validate_repo_implementation
+      @logger.info("Validating repository compatibility")
       config = Config.new(options[:config])
       global_settings = config.global_settings
       validate_hostname(global_settings)
@@ -323,31 +284,29 @@ module Ruborg
       borg_version = Repository.borg_version
       puts "\nBorg version: #{borg_version}\n\n"
 
-      repos_to_check = if options[:all]
-                         config.repositories
-                       elsif options[:repository]
-                         repo_config = config.get_repository(options[:repository])
-                         raise ConfigError, "Repository '#{options[:repository]}' not found" unless repo_config
+      repos_to_validate = if options[:all]
+                            config.repositories
+                          elsif options[:repository]
+                            repo_config = config.get_repository(options[:repository])
+                            raise ConfigError, "Repository '#{options[:repository]}' not found" unless repo_config
 
-                         [repo_config]
-                       else
-                         raise ConfigError, "Please specify --repository or --all"
-                       end
+                            [repo_config]
+                          else
+                            raise ConfigError, "Please specify --repository or --all"
+                          end
 
-      repos_to_check.each do |repo_config|
-        check_repository(repo_config, global_settings)
+      repos_to_validate.each do |repo_config|
+        validate_repository(repo_config, global_settings)
       end
     rescue Error => e
-      @logger.error("Check failed: #{e.message}")
+      @logger.error("Validation failed: #{e.message}")
       raise
     end
 
-    private
-
-    def check_repository(repo_config, global_settings)
+    def validate_repository(repo_config, global_settings)
       repo_name = repo_config["name"]
-      puts "--- Checking repository: #{repo_name} ---"
-      @logger.info("Checking repository: #{repo_name}")
+      puts "--- Validating repository: #{repo_name} ---"
+      @logger.info("Validating repository: #{repo_name}")
 
       merged_config = global_settings.merge(repo_config)
       validate_hostname(merged_config)
@@ -392,11 +351,96 @@ module Ruborg
 
       puts ""
     rescue BorgError => e
-      puts "  ✗ Check failed: #{e.message}"
-      @logger.error("Check failed for #{repo_name}: #{e.message}")
+      puts "  ✗ Validation failed: #{e.message}"
+      @logger.error("Validation failed for #{repo_name}: #{e.message}")
       puts ""
     end
 
+    public
+
+    desc "version", "Show ruborg and borg versions"
+    def version
+      require_relative "version"
+      puts "ruborg #{Ruborg::VERSION}"
+      @logger.info("Version checked: #{Ruborg::VERSION}")
+
+      begin
+        borg_version = Repository.borg_version
+        borg_path = Repository.borg_path
+        puts "borg #{borg_version} (#{borg_path})"
+        @logger.info("Borg version: #{borg_version}, path: #{borg_path}")
+      rescue BorgError => e
+        puts "borg: not found or not executable"
+        @logger.warn("Could not determine Borg version: #{e.message}")
+      end
+    end
+
+    desc "check", "DEPRECATED: Use 'ruborg validate repo' instead"
+    option :verify_data, type: :boolean, default: false, desc: "Verify repository data (slower)"
+    option :all, type: :boolean, default: false, desc: "Validate all repositories"
+    def check
+      puts "\n⚠️  DEPRECATED COMMAND"
+      puts "══════════════════════════════════════════════════════════════════\n\n"
+      puts "The 'ruborg check' command has been renamed for consistency.\n"
+      puts "Please use: ruborg validate repo\n\n"
+      puts "Examples:"
+      puts "  ruborg validate repo --repository documents"
+      puts "  ruborg validate repo --all"
+      puts "  ruborg validate repo --repository documents --verify-data\n\n"
+      puts "══════════════════════════════════════════════════════════════════\n"
+
+      @logger.warn("Deprecated command 'check' was called. User should use 'validate repo' instead.")
+      exit 1
+    end
+
+    desc "metadata ARCHIVE", "Get file metadata from an archive"
+    option :file, type: :string, desc: "Specific file path (required for standard archives, auto for per-file)"
+    def metadata(archive_name)
+      @logger.info("Getting metadata for archive: #{archive_name}")
+      config = Config.new(options[:config])
+
+      raise ConfigError, "Please specify --repository" unless options[:repository]
+
+      repo_config = config.get_repository(options[:repository])
+      raise ConfigError, "Repository '#{options[:repository]}' not found" unless repo_config
+
+      global_settings = config.global_settings
+      merged_config = global_settings.merge(repo_config)
+      validate_hostname(merged_config)
+      passphrase = fetch_passphrase_for_repo(merged_config)
+      borg_opts = merged_config["borg_options"] || {}
+      borg_path = merged_config["borg_path"]
+
+      repo = Repository.new(repo_config["path"], passphrase: passphrase, borg_options: borg_opts, borg_path: borg_path,
+                                                 logger: @logger)
+
+      raise BorgError, "Repository does not exist at #{repo_config["path"]}" unless repo.exists?
+
+      # Get file metadata
+      metadata = repo.get_file_metadata(archive_name, file_path: options[:file])
+
+      # Display metadata
+      puts "\n═══════════════════════════════════════════════════════════════"
+      puts "  FILE METADATA"
+      puts "═══════════════════════════════════════════════════════════════\n\n"
+      puts "Archive: #{archive_name}"
+      puts "File: #{metadata["path"]}"
+      puts "Size: #{format_size(metadata["size"])}"
+      puts "Modified: #{metadata["mtime"]}"
+      puts "Mode: #{metadata["mode"]}"
+      puts "User: #{metadata["user"]}"
+      puts "Group: #{metadata["group"]}"
+      puts "Type: #{metadata["type"]}"
+      puts ""
+
+      @logger.info("Successfully retrieved metadata for #{metadata["path"]}")
+    rescue Error => e
+      @logger.error("Failed to get metadata: #{e.message}")
+      raise
+    end
+
+    private
+
     def show_repositories_summary(config)
       repositories = config.repositories
       global_settings = config.global_settings
@@ -578,10 +622,14 @@ module Ruborg
         end
       end
 
+      # Get skip_hash_check setting (defaults to false)
+      skip_hash_check = merged_config["skip_hash_check"]
+      skip_hash_check = false unless skip_hash_check == true
+
       # Create backup config wrapper
       backup_config = BackupConfig.new(repo_config, merged_config)
       backup = Backup.new(repo, config: backup_config, retention_mode: retention_mode, repo_name: repo_name,
-                                logger: @logger)
+                                logger: @logger, skip_hash_check: skip_hash_check)
 
       archive_name = options[:name] ? sanitize_archive_name(options[:name]) : nil
       @logger.info("Creating archive#{"s" if retention_mode == "per_file"}: #{archive_name || "auto-generated"}")

data/lib/ruborg/config.rb

@@ -41,7 +41,7 @@ module Ruborg
 
     def global_settings
       @data.slice("passbolt", "compression", "encryption", "auto_init", "borg_options", "log_file", "retention",
-                  "auto_prune", "hostname", "allow_remove_source", "borg_path")
+                  "auto_prune", "hostname", "allow_remove_source", "borg_path", "skip_hash_check")
     end
 
     private
@@ -54,12 +54,12 @@ module Ruborg
     # Valid configuration keys at each level
     VALID_GLOBAL_KEYS = %w[
       hostname compression encryption auto_init auto_prune allow_remove_source
-      log_file borg_path passbolt borg_options retention repositories
+      log_file borg_path passbolt borg_options retention repositories skip_hash_check
     ].freeze
 
     VALID_REPOSITORY_KEYS = %w[
       name description path hostname retention_mode passbolt retention sources
-      compression encryption auto_init auto_prune borg_options allow_remove_source
+      compression encryption auto_init auto_prune borg_options allow_remove_source skip_hash_check
     ].freeze
 
     VALID_SOURCE_KEYS = %w[name paths exclude].freeze
@@ -122,8 +122,9 @@ module Ruborg
       errors.concat(validate_boolean_config(@data, "auto_init", "global"))
       errors.concat(validate_boolean_config(@data, "auto_prune", "global"))
       errors.concat(validate_boolean_config(@data, "allow_remove_source", "global"))
+      errors.concat(validate_boolean_config(@data, "skip_hash_check", "global"))
 
-      # Note: borg_options are validated as warnings in CLI validate command, not as errors here
+      # NOTE: borg_options are validated as warnings in CLI validate command, not as errors here
 
       # Validate global passbolt
       errors.concat(validate_passbolt_config(@data["passbolt"], "global")) if @data["passbolt"]
@@ -151,6 +152,7 @@ module Ruborg
         errors.concat(validate_boolean_config(repo, "auto_init", repo_name))
         errors.concat(validate_boolean_config(repo, "auto_prune", repo_name))
         errors.concat(validate_boolean_config(repo, "allow_remove_source", repo_name))
+        errors.concat(validate_boolean_config(repo, "skip_hash_check", repo_name))
 
         # Validate retention_mode
         if repo["retention_mode"] && !VALID_RETENTION_MODES.include?(repo["retention_mode"])
@@ -158,7 +160,7 @@ module Ruborg
                     "Must be one of: #{VALID_RETENTION_MODES.join(", ")}"
         end
 
-        # Note: borg_options are validated as warnings in CLI validate command, not as errors here
+        # NOTE: borg_options are validated as warnings in CLI validate command, not as errors here
 
         errors.concat(validate_passbolt_config(repo["passbolt"], repo_name)) if repo["passbolt"]
 

data/lib/ruborg/repository.rb

@@ -477,6 +477,21 @@ module Ruborg
       match[1]
     end
 
+    # Get Borg path (full path to executable)
+    def self.borg_path(borg_command = "borg")
+      # If it's an absolute or relative path, expand it
+      return File.expand_path(borg_command) if borg_command.include?("/")
+
+      # Otherwise, search in PATH
+      ENV["PATH"].split(File::PATH_SEPARATOR).each do |directory|
+        path = File.join(directory, borg_command)
+        return path if File.executable?(path)
+      end
+
+      # Not found in PATH, return the command as-is
+      borg_command
+    end
+
     # Execute borg version command (extracted for testing)
     def self.execute_version_command(borg_path = "borg")
       require "open3"

data/lib/ruborg/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Ruborg
-  VERSION = "0.8.1"
+  VERSION = "0.9.0"
 end

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ruborg
 version: !ruby/object:Gem::Version
-  version: 0.8.1
+  version: 0.9.0
 platform: ruby
 authors:
 - Michail Pantelelis
+autorequire:
 bindir: exe
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2025-10-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: psych
@@ -160,6 +161,7 @@ metadata:
   source_code_uri: https://github.com/mpantel/ruborg.git
   changelog_uri: https://github.com/mpantel/ruborg/blob/main/CHANGELOG.md
   rubygems_mfa_required: 'true'
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -174,7 +176,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.7.1
+rubygems_version: 3.5.22
+signing_key:
 specification_version: 4
 summary: A friendly Ruby frontend for Borg backup
 test_files: []