cbz_tools 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f7fe3f88fb29727f7962453a2fee499507a67111de66b535e4306dd88a569c19
-  data.tar.gz: 5513eadeb2da736150f1423aff4d4b37ae7229946bcee1e1fbe599894c639295
+  metadata.gz: be6a34e670ac04d6ea7d87875e6ce57eb182dda4f6349f72404ae66ce6a863df
+  data.tar.gz: 46d9ff6e0b8b52d13027a1ea06558947e6407cc0408637acb9acf9cbe03aafe5
 SHA512:
-  metadata.gz: c424857bf97688fb045f1e2f26b7740dd85fc6a8cd38e6cce6acad5c9d3f2a9900b510843b03dc292aaa4873dc68f45fb11ada59730c648988a8eb54d0c10841
-  data.tar.gz: b486e668e9106525f2053d8ac2e36f9271717ee524b934009f1f8f752eb3be007a1de09c281dc1afc36305382de81917d16e280b5dd94aa0d9644f48656252bc
+  metadata.gz: 54063af8baff3b28a84f03d20339d85821f1d0326011faf81afecb4c5081840292a8083a936070d597040cc79ac4833d68c4717fb7a0d0575d68f2fceb823103
+  data.tar.gz: e264ef924c0781ef429da2aa89ee71dbc9ff7c3d37307bf832dd10e633852e1326af140ced09b2aaf8c4d5185deefd76e6dcf45b0b1f6e09a8989619c8dbc59f

data/.vscode/settings.json

@@ -0,0 +1,3 @@
+{
+  "cSpell.words": ["comicinfo"]
+}

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 ## [Unreleased]
 
+## [0.2.0] - 2026-08-03
+
+- Add `CbzTools::Reader` for reading CBZ archives (images and `ComicInfo.xml`)
+
 ## [0.1.1] - 2026-08-03
 
 - Exclude development-only files from the packaged gem

data/lib/cbz_tools/error.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module CbzTools
+  class Error < StandardError; end
+end

data/lib/cbz_tools/reader.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+require "zip"
+
+module CbzTools
+  class Reader
+    IMAGE_EXTENSIONS = %w[.jpg .jpeg .png .webp].freeze
+
+    class ImageNotFoundError < Error; end
+
+    def self.open(path, &block)
+      reader = new(path)
+      block.call(reader)
+    ensure
+      reader&.close
+    end
+
+    def initialize(path)
+      @path = path
+      @zip = Zip::File.open(@path)
+    end
+
+    def close
+      @zip&.close
+      @zip = nil
+    end
+
+    def image_names
+      @zip.entries
+        .reject(&:directory?)
+        .map(&:name)
+        .select { |name| !name.include?("__macosx") && image?(name) }
+        .sort
+    end
+
+    def read(name)
+      entry = @zip.find_entry(name)
+      return nil unless entry
+
+      entry.get_input_stream.read
+    end
+
+    def first_image
+      read(image_names.first)
+    end
+
+    def image(name)
+      data = read(name)
+      raise ImageNotFoundError, "Image '#{name}' not found in #{@path}" unless data
+
+      data
+    end
+
+    def comic_info
+      read("ComicInfo.xml") || read("comicinfo.xml")
+    end
+
+    private
+
+    def image?(name)
+      IMAGE_EXTENSIONS.any? { |ext| name.downcase.end_with?(ext) }
+    end
+  end
+end

data/lib/cbz_tools/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module CbzTools
-  VERSION = "0.1.1"
+  VERSION = "0.2.0"
 end

data/lib/cbz_tools.rb

@@ -1,8 +1,5 @@
 # frozen_string_literal: true
 
 require_relative "cbz_tools/version"
-
-module CbzTools
-  class Error < StandardError; end
-  # Your code goes here...
-end
+require_relative "cbz_tools/error"
+require_relative "cbz_tools/reader"

metadata

@@ -1,14 +1,28 @@
 --- !ruby/object:Gem::Specification
 name: cbz_tools
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - David Figueroa
 bindir: exe
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
-dependencies: []
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rubyzip
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
 description: 'Tools for working with CBZ comic book archives: reading and extracting
   their contents, reading and updating their embedded metadata, and converting CBR
   archives to CBZ.'
@@ -18,10 +32,13 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".vscode/settings.json"
 - CHANGELOG.md
 - LICENSE.txt
 - README.md
 - lib/cbz_tools.rb
+- lib/cbz_tools/error.rb
+- lib/cbz_tools/reader.rb
 - lib/cbz_tools/version.rb
 - sig/cbz_tools.rbs
 homepage: https://github.com/dmfigueroa/cbz_tools