cbz_tools 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d89395bfb15781bbfdc8be6598676bba94f34506f1870bc3704177f5a7b97659
-  data.tar.gz: d0c2bb20ebdafcbcfc7f468502e7669960824ee66648fde194653dd455a9c4b3
+  metadata.gz: be6a34e670ac04d6ea7d87875e6ce57eb182dda4f6349f72404ae66ce6a863df
+  data.tar.gz: 46d9ff6e0b8b52d13027a1ea06558947e6407cc0408637acb9acf9cbe03aafe5
 SHA512:
-  metadata.gz: afed755eb2b4d0867c2c2d6ce7910a45951d73f2c575f177f7263ae646ab5b1df2c4a67897f3248c80f7f7e8c0010489d69d74b1c08c7efb55df6b63a8022241
-  data.tar.gz: 05de04f7c338656391eff82243d9116e1423070d1c60b082a7206bece223c1d442e08d127460e515b3ce8176c1fe44f777279d03f3c50a58f9a5c66c554d4c93
+  metadata.gz: 54063af8baff3b28a84f03d20339d85821f1d0326011faf81afecb4c5081840292a8083a936070d597040cc79ac4833d68c4717fb7a0d0575d68f2fceb823103
+  data.tar.gz: e264ef924c0781ef429da2aa89ee71dbc9ff7c3d37307bf832dd10e633852e1326af140ced09b2aaf8c4d5185deefd76e6dcf45b0b1f6e09a8989619c8dbc59f

data/.vscode/settings.json

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

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 ## [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
+
 ## [0.1.0] - 2026-07-21
 
 - Initial release

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.0"
+  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.0
+  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,13 +32,13 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".rspec"
-- ".standard.yml"
+- ".vscode/settings.json"
 - CHANGELOG.md
 - LICENSE.txt
 - README.md
-- Rakefile
 - 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

data/.rspec

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

data/.standard.yml

@@ -1,3 +0,0 @@
-# For available configuration options, see:
-#   https://github.com/standardrb/standard
-ruby_version: 3.0

data/Rakefile

@@ -1,10 +0,0 @@
-# frozen_string_literal: true
-
-require "bundler/gem_tasks"
-require "rspec/core/rake_task"
-
-RSpec::Core::RakeTask.new(:spec)
-
-require "standard/rake"
-
-task default: %i[spec standard]