darkroom 0.0.8 → 0.0.10

data/lib/darkroom/errors/duplicate_asset_error.rb

@@ -1,30 +1,21 @@
 # frozen_string_literal: true
 
 class Darkroom
-  ##
-  # Error class used when an asset exists under multiple load paths.
-  #
+  # Error class used when the same asset path exists under multiple load paths.
   class DuplicateAssetError < StandardError
     attr_reader(:path, :first_load_path, :second_load_path)
 
-    ##
-    # Creates a new instance.
-    #
-    # [path] Path of the asset that exists under multiple load paths.
-    # [first_load_path] Load path where the asset was first found.
-    # [second_load_path] Load path where the asset was subsequently found.
+    # Public: Create a new instance.
     #
+    # path             - String path of the asset that exists under multiple load paths.
+    # first_load_path  - String load path where the asset was first found.
+    # second_load_path - String load path where the asset was subsequently found.
     def initialize(path, first_load_path, second_load_path)
+      super("Asset file exists in both #{first_load_path} and #{second_load_path}: #{path}")
+
       @path = path
       @first_load_path = first_load_path
       @second_load_path = second_load_path
     end
-
-    ##
-    # Returns a string representation of the error.
-    #
-    def to_s
-      "Asset file exists in both #{@first_load_path} and #{@second_load_path}: #{@path}"
-    end
   end
 end

data/lib/darkroom/errors/invalid_path_error.rb

@@ -3,28 +3,19 @@
 require_relative('../asset')
 
 class Darkroom
-  ##
   # Error class used when an asset's path contains one or more invalid characters.
-  #
   class InvalidPathError < StandardError
     attr_reader(:path, :index)
 
-    ##
-    # Creates a new instance.
-    #
-    # [path] Path of the asset with the invalid character(s).
-    # [index] Position of the first bad character in the path.
+    # Public: Create a new instance.
     #
+    # path  - Path of the asset with the invalid character(s).
+    # index - Position of the first bad character in the path.
     def initialize(path, index)
+      super("Asset path contains one or more invalid characters (#{Asset::DISALLOWED_PATH_CHARS}): #{path}")
+
       @path = path
       @index = index
     end
-
-    ##
-    # Returns a string representation of the error.
-    #
-    def to_s
-      "Asset path contains one or more invalid characters (#{Asset::DISALLOWED_PATH_CHARS}): #{@path}"
-    end
   end
 end

data/lib/darkroom/errors/missing_library_error.rb

@@ -1,31 +1,22 @@
 # frozen_string_literal: true
 
 class Darkroom
-  ##
   # Error class used when a needed library cannot be loaded. See Asset#require_libs.
-  #
   class MissingLibraryError < StandardError
     attr_reader(:library, :need, :extension)
 
-    ##
-    # Creates a new instance.
-    #
-    # [library] Name of the library that's missing.
-    # [need] Reason the library is needed ('pre-process', 'post-process', or 'minify').
-    # [extension] Extension of the type of asset that needs the library.
+    # Public: Create a new instance.
     #
+    # library   - String name of the library that's missing.
+    # need      - Symbol or String reason the library is needed (:compile, :finalize, or :minify).
+    # extension - String extension of the type of asset that needs the library.
     def initialize(library, need, extension)
+      super("Cannot #{need} #{extension} files: '#{library}' library not available [hint: try adding " \
+        "gem('#{library}') to your Gemfile]")
+
       @library = library
       @need = need
       @extension = extension
     end
-
-    ##
-    # Returns a string representation of the error.
-    #
-    def to_s
-      "Cannot #{@need} #{@extension} file(s): #{@library} library not available [hint: try adding "\
-      "gem('#{@library}') to your Gemfile]"
-    end
   end
 end

data/lib/darkroom/errors/processing_error.rb

@@ -1,35 +1,28 @@
 # frozen_string_literal: true
 
 class Darkroom
-  ##
   # Error class used to wrap all accumulated errors encountered during asset processing.
-  #
   class ProcessingError < StandardError
-    ##
-    # Creates a new instance.
-    #
-    # [errors] Error or array of errors.
+    include(Enumerable)
+
+    # Public: Create a new instance.
     #
+    # errors - Error or Array of errors.
     def initialize(errors)
       @errors = Array(errors)
-    end
 
-    ##
-    # Returns a string representation of the error.
-    #
-    def to_s
-      lines = @errors.map do |error|
-        error.kind_of?(AssetError) ? error.to_s : "#{error.inspect} at #{error.backtrace[0]}"
-      end
-
-      "Errors were encountered while processing assets:\n  #{lines.join("\n  ")}"
+      super("Errors were encountered while processing assets:\n  #{@errors.map(&:to_s).join("\n  ")}")
     end
 
-    ##
-    # Passes any missing method call on to the @errors array.
+    # Public: Iterate over each error.
+    #
+    # block - Block to call and pass each error to.
+    #
+    # Yields each error to the provided block.
     #
-    def method_missing(m, *args, &block)
-      @errors.send(m, *args, &block)
+    # Returns Enumerator object.
+    def each(&block)
+      @errors.each(&block)
     end
   end
 end

data/lib/darkroom/errors/unrecognized_extension_error.rb

@@ -3,17 +3,13 @@
 require_relative('asset_error')
 
 class Darkroom
-  ##
   # Error class used when a reference is made to a file with an unrecognized extension.
-  #
   class UnrecognizedExtensionError < AssetError
-    ##
-    # Creates a new instance.
-    #
-    # [file] File with the unrecognized extension.
-    # [source_path] Path of the asset that contains the error.
-    # [source_line_num] Line number in the asset where the error is located.
+    # Public: Create a new instance.
     #
+    # file            - String file path with the unrecognized extension.
+    # source_path     - String path of the asset that contains the error.
+    # source_line_num - Integer line number in the asset file where the error is located.
     def initialize(file, source_path = nil, source_line_num = nil)
       super('File extension not recognized', file, source_path, source_line_num)
     end

data/lib/darkroom/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 class Darkroom
-  VERSION = '0.0.8'
+  VERSION = '0.0.10'
 end

data/lib/darkroom.rb

@@ -1,16 +1,17 @@
 # frozen_string_literal: true
 
-require('darkroom/asset')
 require('darkroom/darkroom')
-require('darkroom/delegate')
 require('darkroom/version')
 
-require('darkroom/delegates/css')
-require('darkroom/delegates/html')
-require('darkroom/delegates/htx')
-require('darkroom/delegates/javascript')
+require('darkroom/delegates/css_delegate')
+require('darkroom/delegates/html_delegate')
+require('darkroom/delegates/htx_delegate')
+require('darkroom/delegates/javascript_delegate')
 
+Darkroom.register('.apng', 'image/apng')
+Darkroom.register('.avif', 'image/avif')
 Darkroom.register('.css', Darkroom::CSSDelegate)
+Darkroom.register('.gif', 'image/gif')
 Darkroom.register('.htm', '.html', Darkroom::HTMLDelegate)
 Darkroom.register('.htx', Darkroom::HTXDelegate)
 Darkroom.register('.ico', 'image/x-icon')
@@ -20,5 +21,6 @@ Darkroom.register('.json', 'application/json')
 Darkroom.register('.png', 'image/png')
 Darkroom.register('.svg', 'image/svg+xml')
 Darkroom.register('.txt', 'text/plain')
+Darkroom.register('.webp', 'image/webp')
 Darkroom.register('.woff', 'font/woff')
 Darkroom.register('.woff2', 'font/woff2')

metadata

@@ -1,58 +1,65 @@
 --- !ruby/object:Gem::Specification
 name: darkroom
 version: !ruby/object:Gem::Version
-  version: 0.0.8
+  version: 0.0.10
 platform: ruby
 authors:
 - Nate Pickens
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-07-16 00:00:00.000000000 Z
+date: 2025-02-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: bundler
+  name: base64
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
-  type: :development
+        version: '0.2'
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '0.2'
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 5.11.2
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 6.0.0
+        version: '5.24'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.24'
+- !ruby/object:Gem::Dependency
+  name: minitest-reporters
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 5.11.2
-    - - "<"
+        version: '1.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 6.0.0
+        version: '1.7'
 description: Darkroom provides web asset compilation, bundling, and minification without
   any external tools, manifest files, or special comment syntax. CSS and JavaScript
   bundles are automatically generated based on import statements native to each language.
   Darkroom is also extensible, allowing support to be added for arbitrary file types.
-email:
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- CHANGELOG.md
 - LICENSE
 - README.md
 - VERSION
@@ -60,10 +67,10 @@ files:
 - lib/darkroom/asset.rb
 - lib/darkroom/darkroom.rb
 - lib/darkroom/delegate.rb
-- lib/darkroom/delegates/css.rb
-- lib/darkroom/delegates/html.rb
-- lib/darkroom/delegates/htx.rb
-- lib/darkroom/delegates/javascript.rb
+- lib/darkroom/delegates/css_delegate.rb
+- lib/darkroom/delegates/html_delegate.rb
+- lib/darkroom/delegates/htx_delegate.rb
+- lib/darkroom/delegates/javascript_delegate.rb
 - lib/darkroom/errors/asset_error.rb
 - lib/darkroom/errors/asset_not_found_error.rb
 - lib/darkroom/errors/circular_reference_error.rb
@@ -77,10 +84,10 @@ homepage: https://github.com/npickens/darkroom
 licenses:
 - MIT
 metadata:
-  allowed_push_host: https://rubygems.org
-  homepage_uri: https://github.com/npickens/darkroom
-  source_code_uri: https://github.com/npickens/darkroom
-post_install_message:
+  bug_tracker_uri: https://github.com/npickens/darkroom/issues
+  changelog_uri: https://github.com/npickens/darkroom/blob/master/CHANGELOG.md
+  documentation_uri: https://github.com/npickens/darkroom/blob/0.0.10/README.md
+  source_code_uri: https://github.com/npickens/darkroom/tree/0.0.10
 rdoc_options: []
 require_paths:
 - lib
@@ -88,15 +95,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.5.8
+      version: 3.0.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 2.0.0
 requirements: []
-rubygems_version: 3.4.15
-signing_key:
+rubygems_version: 3.6.3
 specification_version: 4
-summary: A fast, lightweight, and straightforward web asset management library.
+summary: A simple and straightforward web asset management library.
 test_files: []