yobi 0.3.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 47dd32402940fcd7c2699d932ca4a4e0db0f6e1ca4e8342ac5d41abc1cbe6114
-  data.tar.gz: 888feb226907437769093ffbad5245f159e5879acb9a6a12de77e908ef14ed51
+  metadata.gz: 56739c72c75a1d5c856bbd619b781dd3986cf1b3c1447d4864edd19b9543d8d9
+  data.tar.gz: a5321fe628cab2f74011ce257a4eee380ed1fcb804456f8afa5482ac84c96b6f
 SHA512:
-  metadata.gz: d9d683046fe0d910622731b5e527f2fda6a93ddf753bc849d9066ae2432667fe4feb2a3c404c48f7e0a54c7cacb5442bf7b1ab36cefd17d24e21388932342893
-  data.tar.gz: 46c31f00651a04b6fd67ec3ccba73ff1bca4b6f2f8deccd3f18233f274d0c8c1394f19d4472dd96013ac340adb225d20f4fc87e8a41d49eeeef9f34dd256b8d4
+  metadata.gz: 9b2253d54dd64aa88658c7ddd53734a2edbcaf2623bb98258bc14d71d0d4a82bb3bcb447e6434bfb28505d2bfcd329988841d8f491ce7c3d1b13865b4a50b0f7
+  data.tar.gz: 7cd169b509d216a99b258180381c9caa9cd92837b822467781b01c3788cc37af4252d825b4de50a511b71a521a4e8d9bff8317a7f9c0da11b82847c6b65c2b8c

data/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [0.3.1] - 2026-08-10
+
+### Fixed
+
+- `#forget`/`#init`/`#stats`/`#find`/`#snapshots`/`#key_list`/the `#cat_*` methods no longer raise a bare, uninformative `JSON::ParserError` when Restic exits with code 3 ("succeeded with warnings" - e.g. `#forget` failing to remove one or more snapshots) and mixes a plain-text diagnostic line into otherwise-JSON output. Raises `Yobi::ResticCommandFailed` instead, with the diagnostic still available in the error message.
+
 ## [0.3.0] - 2026-08-03
 
 ### Changed

data/lib/yobi/repository/cat.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require "json"
-
 module Yobi
   class Repository
     # `restic cat config`: the repository's own config document.
@@ -10,7 +8,7 @@ module Yobi
     # @raise [Yobi::RepositoryNotFound, Yobi::AuthenticationFailed]
     def cat_config
       execution = run_restic(build_argv("cat", "config"))
-      JSON.parse(execution[:output].to_s)
+      parse_json_output(execution)
     end
     alias_method :config, :cat_config
 
@@ -21,7 +19,7 @@ module Yobi
     def cat_snapshot(id)
       id = id.id if id.is_a?(Yobi::Snapshot)
       execution = run_restic(build_argv("cat", "snapshot", id))
-      JSON.parse(execution[:output].to_s)
+      parse_json_output(execution)
     end
 
     # `restic cat index ID`: one index file's own raw contents. IDs come
@@ -31,7 +29,7 @@ module Yobi
     # @return [Hash]
     def cat_index(id)
       execution = run_restic(build_argv("cat", "index", id))
-      JSON.parse(execution[:output].to_s)
+      parse_json_output(execution)
     end
 
     # `restic cat key ID`: one key's own raw stored record.
@@ -41,7 +39,7 @@ module Yobi
     def cat_key(id)
       id = id.id if id.is_a?(Yobi::Key)
       execution = run_restic(build_argv("cat", "key", id))
-      JSON.parse(execution[:output].to_s)
+      parse_json_output(execution)
     end
 
     # `restic cat tree snapshot:subfolder`: the raw tree object at a
@@ -58,7 +56,7 @@ module Yobi
         "#{snapshot_id}:#{subfolder}"
       end
       execution = run_restic(build_argv("cat", "tree", target))
-      JSON.parse(execution[:output].to_s)
+      parse_json_output(execution)
     end
 
     # `restic cat pack ID`: one pack file's raw, still-encrypted bytes.
@@ -91,7 +89,7 @@ module Yobi
     # @return [Hash]
     def cat_masterkey_and_game_over_if_this_leaks
       execution = run_restic(build_argv("cat", "masterkey"))
-      JSON.parse(execution[:output].to_s)
+      parse_json_output(execution)
     end
   end
 end

data/lib/yobi/repository/find.rb

@@ -1,6 +1,5 @@
 # frozen_string_literal: true
 
-require "json"
 require "time"
 
 module Yobi
@@ -45,7 +44,7 @@ module Yobi
         a.end_of_options.append(patterns)
       end
       execution = run_restic(argv)
-      JSON.parse(execution[:output].to_s).map { |raw| MatchesPerSnapshot.new(raw) }
+      parse_json_output(execution).map { |raw| MatchesPerSnapshot.new(raw) }
     end
   end
 

data/lib/yobi/repository/forget.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require "json"
-
 module Yobi
   class Repository
     # `restic forget`: applies a retention policy, removing snapshots
@@ -69,7 +67,7 @@ module Yobi
         a.flag(:repack_smaller_than, repack_smaller_than) unless repack_smaller_than.nil?
       end
       execution = run_restic(argv)
-      JSON.parse(execution[:output].to_s).map { |raw| ForgetGroup.new(raw) }
+      parse_json_output(execution).map { |raw| ForgetGroup.new(raw) }
     end
   end
 

data/lib/yobi/repository/init.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require "json"
-
 module Yobi
   class Repository
     # `restic init`: creates the repository at {#url}.
@@ -33,7 +31,7 @@ module Yobi
       end
 
       execution = run_restic(argv, extra_env: password_env(from_password, "RESTIC_FROM_PASSWORD"))
-      Initialized.new(JSON.parse(execution[:output].to_s))
+      Initialized.new(parse_json_output(execution))
     end
 
     # Constructs a new {Yobi::Repository} at `url`, already initialized with

data/lib/yobi/repository/key.rb

@@ -37,7 +37,7 @@ module Yobi
     # @return [Array<Yobi::Key>]
     def key_list
       execution = run_restic(build_argv("key", "list"))
-      JSON.parse(execution[:output].to_s).map { |raw| Key.new(raw) }
+      parse_json_output(execution).map { |raw| Key.new(raw) }
     end
     alias_method :keys, :key_list
 

data/lib/yobi/repository/snapshots.rb

@@ -23,7 +23,7 @@ module Yobi
         a.flag(:latest, latest) unless latest.nil?
       end
       execution = run_restic(argv)
-      JSON.parse(execution[:output].to_s).map { |raw| Snapshot.new(raw) }
+      parse_json_output(execution).map { |raw| Snapshot.new(raw) }
     end
   end
 end

data/lib/yobi/repository/stats.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require "json"
-
 module Yobi
   class Repository
     # @private
@@ -29,7 +27,7 @@ module Yobi
         a.repeat_flag(:tag, tags)
       end
       execution = run_restic(argv)
-      RepositoryStats.new(JSON.parse(execution[:output].to_s))
+      RepositoryStats.new(parse_json_output(execution))
     end
   end
 

data/lib/yobi/repository.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require "json"
 require "uri"
 
 module Yobi
@@ -62,6 +63,21 @@ module Yobi
       builder.to_a
     end
 
+    # Parses a command's captured output as JSON. If parsing fails, raises
+    # {Yobi::ResticCommandFailed} when `execution[:exit_code]` is `3`
+    # (Restic reported a problem alongside otherwise-JSON output), or
+    # re-raises the original +JSON::ParserError+ when it's `0`.
+    #
+    # @param execution [Hash] `{exit_code:, output:, argv:}`
+    # @return [Object] the parsed JSON
+    # @raise [Yobi::ResticCommandFailed] if parsing fails and `exit_code` is `3`
+    def parse_json_output(execution)
+      JSON.parse(execution[:output].to_s)
+    rescue JSON::ParserError
+      raise if execution[:exit_code].zero?
+      raise Yobi::ResticCommandFailed, execution
+    end
+
     def resolved_password
       password_env(password)
     end

data/lib/yobi/version.rb

@@ -4,5 +4,5 @@
 # plain Ruby objects instead of shelling out to flags and raw JSON by hand.
 module Yobi
   # @return [String]
-  VERSION = "0.3.0"
+  VERSION = "0.3.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: yobi
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.3.1
 platform: ruby
 authors:
 - Zia Perdana
@@ -61,7 +61,7 @@ metadata:
   homepage_uri: https://codeberg.org/ukazap/yobi
   source_code_uri: https://codeberg.org/ukazap/yobi
   changelog_uri: https://codeberg.org/ukazap/yobi/src/branch/main/CHANGELOG.md
-  documentation_uri: https://rubydoc.info/gems/yobi/0.3.0
+  documentation_uri: https://rubydoc.info/gems/yobi/0.3.1
 rdoc_options: []
 require_paths:
 - lib