bard-backup 0.13.0 → 0.14.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 51001d22a2e69c99f9bb208bca62d65796d6380836e4591046d202a435352760
-  data.tar.gz: b7d759d4be19c813749b8861b974a56acbf986dcc0fcf1542e29bd6bf3816527
+  metadata.gz: 500bd736142fc1765b02fdbee4923a35dd4d09bd3cabd825706d7b64b9ad3fff
+  data.tar.gz: 07c8d6686725ebd36364da96df0e8f66d80c87ddbf3751e1a86f0e12ead8a78c
 SHA512:
-  metadata.gz: e04e6a895738ea48bb2d60dbbd357d33ff5941c9ad0039b30726168c35aa5f4662522cd295965cd63c6d45cbfc4251766128ce548daf8d60d37dd02f05a5db37
-  data.tar.gz: 34f4cb5549b78961a9dc29f11818b98f5f45f2f6ec0d80aa9c17ca80a4ab9a88bd98fb96889122096fdd0c9f347d0b4a900d075448ded24384555fea50f7a550
+  metadata.gz: f1893706b187e49ad3a16b5fc8fa5a2de0644e522041f7d7a1d4bf9f54054ca8094956a3f26c7a83f7e598097af94726fbbb5d3dc876a5fad90e47e71a2d460d
+  data.tar.gz: eb744cd047d227b37de6b723b5e5ec027b8f1c03dd663fc735abfad2165370536a2b727c068b3d5624b64ce9e3ff79b54fc1ea925cfbb30aa6e85ba2ae0cc598

data/CLAUDE.md

@@ -45,7 +45,7 @@ Tests require AWS credentials at `spec/support/credentials.json`. In CI, this is
 **Entry points**:
 - `Bard::Backup.create!` accepts destination configs (or reads from `Bard::Config`) and delegates to destination strategies. Returns a `Bard::Backup` instance with timestamp/size/destinations.
 - `Bard::Backup::FileTree.create!` syncs configured data directories to S3.
-- `Bard::Backup.restore!(at:)` downloads the backup nearest `at` (or the latest when omitted), decrypts it if necessary, and loads it into the local database via `backhoe` (drop-and-create). `Bard::Backup.available` lists the available backup timestamps.
+- `Bard::Backup.restore!(at:)` downloads the backup nearest `at` (or the latest when omitted), decrypts it if necessary, and loads it into the local database via `backhoe` (drop-and-create). `Bard::Backup.available` lists the available backups (as `Bard::Backup` objects carrying timestamp and size).
 
 **Destination strategy pattern**: `Destination.build(config)` is a factory that picks the right class based on `:type`. `Destination.resolve(hashes)` is the single entry point both `Database.create!` and `Finder` use — it falls back to the configured destinations, normalizes a lone Hash/Array, and builds them. Each destination resolves its own `encryption_key` (explicit config, falling back to `Bard::Config.current.backup.encryption_key`), so callers never inject it.
 - `S3Destination` — dumps DB locally via backhoe, uploads to S3, runs `Deleter` for retention, verifies previous hour's backup
@@ -65,7 +65,7 @@ end
 - `Encryptor` — AES-256-GCM with HKDF-derived keys and a deterministic IV (HMAC of plaintext), enabling content-addressable encryption
 - `Deleter` — implements the retention policy via `Filter` structs that check time-based granularities
 - `LocalBackhoe` / `CachedLocalBackhoe` — database dump strategies (cached variant avoids conflicts when running parallel destinations)
-- `Finder` — lists backups across destinations and selects one: by timestamp (nearest match), the latest, or the most-recent as a `Bard::Backup` (with size + destination info). Backs `Bard::Backup.available`/`.latest` and `Restore`
+- `Finder` — lists backups across destinations and selects one: by timestamp (nearest match), the latest, or the most-recent as a `Bard::Backup` (with size + destination info). `#available` returns one `Bard::Backup` per timestamp (with size) for listing. Backs `Bard::Backup.available`/`.latest` and `Restore`
 - `Restore` — downloads the backup selected by `Finder`, decrypts it via `S3Tree#get`, and loads it into the local database via backhoe (drop-and-create). Backs `Bard::Backup.restore!`
 - `BackupConfig` — the `backup do ... end` DSL surface (`bard`, `disabled`, `s3 name, **kwargs`); `create!` reads `bard_config.backup.destinations` from it
 - `Railtie` — loads `tasks.rake` which provides `bard:backup` (DB + data), `bard:backup:data` (data only), and `bard:backup:restore[at]` (restore/list) rake tasks in Rails apps

data/lib/bard/backup/finder.rb

@@ -26,6 +26,19 @@ module Bard
         all.map { |backup| backup[:timestamp] }.uniq.sort
       end
 
+      def available
+        all
+          .group_by { |backup| backup[:timestamp] }
+          .sort_by { |timestamp, _| timestamp }
+          .map do |timestamp, backups|
+            Bard::Backup.new(
+              timestamp:,
+              size: file_size(backups.first[:destination].s3_tree, backups.first[:filename]),
+              destinations: backups.map { |backup| backup[:destination].info },
+            )
+          end
+      end
+
       def find(at: nil)
         backups = all
         raise NotFound, "No backups found" if backups.empty?

data/lib/bard/backup/tasks.rake

@@ -26,9 +26,11 @@ namespace :bard do
 
       destinations = Bard::Config.current.backup.destinations
       if args[:at].to_s.strip.empty?
-        timestamps = Bard::Backup.available(destinations: destinations)
+        backups = Bard::Backup.available(destinations: destinations)
         puts "Available backups:"
-        timestamps.each { |timestamp| puts "  #{timestamp.iso8601}" }
+        backups.each do |backup|
+          puts "  #{backup.timestamp.iso8601}  #{backup.human_size}"
+        end
       else
         backup = Bard::Backup.restore!(at: args[:at], destinations: destinations)
         puts "Restored database from backup #{backup.timestamp.iso8601}."

data/lib/bard/backup/version.rb

@@ -1,6 +1,6 @@
 module Bard
   class Backup
-    VERSION = "0.13.0"
+    VERSION = "0.14.0"
   end
 end
 

data/lib/bard/backup.rb

@@ -22,7 +22,7 @@ module Bard
     end
 
     def self.available(destinations: nil)
-      Finder.new(destinations).timestamps
+      Finder.new(destinations).available
     end
 
     def self.restore!(at:, drop_and_create: true, destinations: nil)
@@ -44,5 +44,15 @@ module Bard
         destinations: destinations
       }.compact
     end
+
+    def human_size
+      units = %w[Bytes KB MB GB TB PB EB]
+      value, unit = size.to_f, 0
+      while value >= 1024 && unit < units.size - 1
+        value /= 1024
+        unit += 1
+      end
+      format("%5.2f %s", value, units[unit])
+    end
   end
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: bard-backup
 version: !ruby/object:Gem::Version
-  version: 0.13.0
+  version: 0.14.0
 platform: ruby
 authors:
 - Micah Geisel
 bindir: exe
 cert_chain: []
-date: 2026-07-09 00:00:00.000000000 Z
+date: 2026-07-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: backhoe