middlemac-extras 1.0.6 → 1.0.11

data/middlemac-extras.gemspec

@@ -2,26 +2,53 @@
 $:.push File.expand_path('../lib', __FILE__)
 require 'middlemac-extras/version'
 
+# We should work with any 4.3.x version of Middleman, but due to #2319,
+# automatic image alt attributes have been removed from Middleman, so
+# I'm adjusting the minimum requirement to the first release incorporating
+# that change.
+
+mm_needed = ['~> 4.3.0', '>= 4.3.7']
+
+# We should work with any 2.0 version of Ruby, but I'm no longer testing them
+# for regressions. Version 2.6.0 goes back to December 2018, and is a suitable
+# minimum version.
+#
+# Currently no released version of Middleman works with Ruby 3, so until that is
+# resolved, We will only support 2.6 up to and not including Ruby 3.0.
+
+rb_needed = ['~> 2.0', '>= 2.6']
+
+
 Gem::Specification.new do |s|
-  s.name        = 'middlemac-extras'
-  s.version     = Middleman::MiddlemacExtras::VERSION
-  s.platform    = Gem::Platform::RUBY
-  s.authors     = ['Jim Derry']
-  s.email       = ['balthisar@gmail.com']
-  s.homepage    = 'https://github.com/middlemac/middlemac-extras'
-  s.summary     = 'Implements several useful developer conveniences for Middleman projects.'
-  s.description = 'Implements several useful developer conveniences for Middleman projects.'
-  s.license     = 'MIT'
-
-  s.files         = `git ls-files`.split("\n")
-  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
-  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
-  s.require_paths = ['lib']
+
+  s.required_ruby_version = rb_needed
+  s.name                  = 'middlemac-extras'
+  s.version               = Middleman::MiddlemacExtras::VERSION
+  s.platform              = Gem::Platform::RUBY
+  s.authors               = ['Jim Derry']
+  s.email                 = ['balthisar@gmail.com']
+  s.homepage              = 'https://github.com/middlemac/middlemac-extras'
+  s.summary               = 'Implements several useful developer conveniences for Middleman projects.'
+  s.description           = 'Implements several useful developer conveniences for Middleman projects.'
+  s.license               = 'MIT'
+
+  s.files                 = `git ls-files`.split("\n")
+  s.test_files            = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables           = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths         = ['lib']
   
   # The version of middleman-core your extension depends on
-  s.add_runtime_dependency('middleman-core', ['~> 4.1', '>= 4.1.6'])
+  s.add_runtime_dependency('middleman-core', mm_needed)
 
   # Additional dependencies
-  s.add_runtime_dependency('middleman-cli', ['~> 4.1', '>= 4.1.6'])
-  s.add_runtime_dependency('fastimage', ['~> 1.9', '>= 1.9.0'])
+  s.add_runtime_dependency('middleman-cli', mm_needed)
+  s.add_runtime_dependency('fastimage', ['~> 2.0'])
+  
+  # Development dependencies
+  s.add_development_dependency 'middleman', mm_needed
+  s.add_development_dependency 'bundler',   '>= 1.6'
+  s.add_development_dependency 'rake',      '>= 10.3'
+  s.add_development_dependency 'git'
+  s.add_development_dependency 'capybara', ['~> 2.5.0']
+  
 end

data/yard/readme.md

@@ -0,0 +1,6 @@
+This gem provides conveniences to **Middleman** projects such as CSS-based image
+size limits; easy-to-use Markdown link references (including title!);
+easy-to-use Markdown image references; and an enhanced `image_tag` helper
+that includes @2x images automatically.
+
+It is standalone and can be used in any **Middleman** project.

data/yard/template-grouped/default/module/html/method_details_list.erb

@@ -0,0 +1,11 @@
+<% scopes(method_listing(false)) do |list, scope| %>
+  <div id="<%= scope %>_method_details" class="method_details_list">
+    <% groups = list.group_by { |g| g.group.nil? ? 'ZZZ' : g.group }.sort.to_h %>
+    <% groups.each_value do |group| %>
+      <h2><%= group[0].group || "#{scope.to_s.capitalize} Method Details" %></h2>
+      <% group.each_with_index do |meth, i| %>
+        <%= yieldall :object => meth, :owner => object, :index => i %>
+      <% end %>
+    <% end %>
+  </div>
+<% end %>

data/yard/template-partials/default/method_details/setup.rb

@@ -0,0 +1,4 @@
+def init
+  super
+  sections :header, [:method_signature, T('docstring')]
+end

data/yard/template-partials/default/module/html/attribute_details.erb

@@ -0,0 +1,9 @@
+<% scopes(attr_listing) do |list, scope| %>
+  <div id="<%= scope %>_attr_details" class="attr_details">
+    <% list.each_with_index do |meth, i| %>
+      <% rw = meth.attr_info %>
+      <span id="<%= anchor_for(rw[meth.reader? ? :write : :read]) %>"></span>
+      <%= yieldall :object => meth, :owner => object, :index => i %>
+    <% end %>
+  </div>
+<% end %>

data/yard/template-partials/default/module/html/method_details_list.erb

@@ -0,0 +1,10 @@
+<% scopes(method_listing(false)) do |list, scope| %>
+  <div class="method_details_list">
+    <% groups = list.group_by { |g| g.group.nil? ? 'ZZZ' : g.group }.sort.to_h %>
+    <% groups.each_value do |group| %>
+      <% group.each_with_index do |meth, i| %>
+        <%= yieldall :object => meth, :owner => object, :index => i %>
+      <% end %>
+    <% end %>
+  </div>
+<% end %>

data/yard/template-partials/default/module/setup.rb

@@ -0,0 +1,6 @@
+include Helpers::ModuleHelper
+
+def init
+  sections :attribute_details, [T('method_details')],
+           :method_details_list, [T('method_details')]
+end

data/yard/template-partials/default/onefile/html/layout.erb

@@ -0,0 +1 @@
+<%= yieldall %>

data/yard/template-partials/default/onefile/html/setup.rb

@@ -0,0 +1,4 @@
+def init
+  super
+  sections :layout, [:all_objects]
+end

data/yard/yard_extensions.rb

@@ -0,0 +1,109 @@
+##########################################################################
+# Our template groups the methods by @group instead of lumping all of 
+# them together as instance methods. This is because most of them simply
+# *aren't* instance methods but rather helpers or resource methods.
+# This template will be used by default because .yardopts loads this
+# file; however `rake partials` will override this template via the
+# command line in order to use the `template-partials` instead.
+##########################################################################
+YARD::Templates::Engine.register_template_path File.join(File.dirname(__FILE__), 'template-grouped')
+
+##########################################################################
+# Force Yard to parse the helpers block in a Middleman extension.
+#
+#  * Assign a generic "Helpers" group to each item if they don't have
+#    their own @group assignment. Note that @!group doesn't work in this
+#    section.
+#  * Add a @note to each item to distinguish them in a mixed up instance
+#    method detail section.
+##########################################################################
+class HelpersHandler < YARD::Handlers::Ruby::Base
+  handles method_call(:helpers)
+  namespace_only
+
+  def process
+
+    statement.last.last.each do |node|
+
+      extra = ''
+
+      # Find out if there's a @group assigned.
+      extra << '@group Helpers' unless node.docstring.match(/^@group (.*?)$/i)
+
+      # Clean up the doc string because we like - and = borders.
+      # Force the note and group on each of these "fake" methods.
+      if node.docstring
+        docstring = node.docstring
+        docstring = docstring.gsub(/^[\-=]+\n/, '')
+        docstring = docstring.gsub(/[\-=]+$/, '')
+        docstring << extra
+        node.docstring = docstring
+      else
+        node.docstring = extra
+      end
+
+      parse_block(node, :owner => self.owner)
+    end # do
+
+  end # def
+
+end # class
+
+
+##########################################################################
+# Force Yard to parse the resources.each block in a Middleman extension.
+#
+#  * Assign a generic "Resource Extensions" group to each item if they
+#    don't have their own @group assignment. Note that @!group
+#    doesn't work in this section.
+#  * Force each item to have a `@visibility public` because we will
+#    probably have `@visibility private` in the wrapping method.
+#  * Add a @note to each item to distinguish them in a mixed up instance
+#    method detail section.
+##########################################################################
+class ResourcesHandler < YARD::Handlers::Ruby::Base
+  handles :def
+  namespace_only
+
+  def process
+    extra = <<HEREDOC
+@visibility public
+HEREDOC
+
+    return unless statement.method_name(true).to_sym == :manipulate_resource_list
+
+    # Block consists of everything in the actual `do` block
+    block = statement.last.first.last.last
+    block.each do | node |
+      if node.type == :defs
+        # Clean up the doc string because we like - and = borders.
+        # Force the note and public on each of these "fake" methods.
+        if node.docstring
+          docstring = node.docstring
+          docstring = docstring.gsub(/^[\-=]+\n/, '')
+          docstring = docstring.gsub(/[\-=]+$/, '')
+          docstring << extra
+        else
+          docstring = extra
+        end
+
+        # Find out if there's a @group assigned.
+        if ( group = docstring.match(/^@group (.*?)$/i) )
+          group = group[1]
+        else
+          group = 'Resource Extensions'
+        end
+
+        def_name = node[2][0]
+        object = YARD::CodeObjects::MethodObject.new(namespace, "resource.#{def_name}")
+        register(object)
+        object.dynamic = true
+        object.source = node.source.clone
+        object[:docstring] = docstring
+        object[:group] = group
+      end
+    end # do
+
+  end # def
+
+end # class

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: middlemac-extras
 version: !ruby/object:Gem::Version
-  version: 1.0.6
+  version: 1.0.11
 platform: ruby
 authors:
 - Jim Derry
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2016-04-08 00:00:00.000000000 Z
+date: 2021-04-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: middleman-core
@@ -16,60 +16,130 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '4.1'
+        version: 4.3.0
     - - ">="
       - !ruby/object:Gem::Version
-        version: 4.1.6
+        version: 4.3.7
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '4.1'
+        version: 4.3.0
     - - ">="
       - !ruby/object:Gem::Version
-        version: 4.1.6
+        version: 4.3.7
 - !ruby/object:Gem::Dependency
   name: middleman-cli
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '4.1'
+        version: 4.3.0
     - - ">="
       - !ruby/object:Gem::Version
-        version: 4.1.6
+        version: 4.3.7
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '4.1'
+        version: 4.3.0
     - - ">="
       - !ruby/object:Gem::Version
-        version: 4.1.6
+        version: 4.3.7
 - !ruby/object:Gem::Dependency
   name: fastimage
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.9'
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: middleman
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.3.0
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.9.0
-  type: :runtime
+        version: 4.3.7
+  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.9'
+        version: 4.3.0
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 4.3.7
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '10.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '10.3'
+- !ruby/object:Gem::Dependency
+  name: git
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.9.0
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: capybara
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.5.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.5.0
 description: Implements several useful developer conveniences for Middleman projects.
 email:
 - balthisar@gmail.com
@@ -78,7 +148,9 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- ".gitattributes"
 - ".gitignore"
+- ".yardopts"
 - CHANGELOG.md
 - Gemfile
 - LICENSE.md
@@ -89,6 +161,7 @@ files:
 - documentation_project/Gemfile
 - documentation_project/README.md
 - documentation_project/config.rb
+- documentation_project/source/api_reference.html.md.erb
 - documentation_project/source/archives/about.html.md.erb
 - documentation_project/source/archives/index.html.md.erb
 - documentation_project/source/archives/past_far/about.html.md.erb
@@ -126,38 +199,60 @@ files:
 - documentation_project/source/license.html.md.erb
 - documentation_project/source/md_images.html.md.erb
 - documentation_project/source/md_links.html.md.erb
+- documentation_project/source/partials/_yard_config.erb
+- documentation_project/source/partials/_yard_helpers.erb
+- documentation_project/source/partials/_yard_helpers_extended.erb
 - documentation_project/source/stylesheets/_github.scss
 - documentation_project/source/stylesheets/_middlemac_minimal.scss
 - documentation_project/source/stylesheets/_normalize.scss
 - documentation_project/source/stylesheets/css_image_sizes.css.erb
 - documentation_project/source/stylesheets/style.css.scss
+- features/helpers.feature
+- features/support/env.rb
+- fixtures/middlemac_extras_app/config.rb
+- fixtures/middlemac_extras_app/source/images/middlemac-extras-small.png
+- fixtures/middlemac_extras_app/source/images/middlemac-extras-small@2x.png
+- fixtures/middlemac_extras_app/source/images/middlemac-extras-smaller.png
+- fixtures/middlemac_extras_app/source/index.html.md.erb
 - lib/middlemac-extras.rb
 - lib/middlemac-extras/extension.rb
 - lib/middlemac-extras/version.rb
 - middlemac-extras.gemspec
+- yard/readme.md
+- yard/template-grouped/default/module/html/method_details_list.erb
+- yard/template-partials/default/method_details/setup.rb
+- yard/template-partials/default/module/html/attribute_details.erb
+- yard/template-partials/default/module/html/method_details_list.erb
+- yard/template-partials/default/module/setup.rb
+- yard/template-partials/default/onefile/html/layout.erb
+- yard/template-partials/default/onefile/html/setup.rb
+- yard/yard_extensions.rb
 homepage: https://github.com/middlemac/middlemac-extras
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
+  - - "~>"
+    - !ruby/object:Gem::Version
+      version: '2.0'
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '2.6'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.4.8
-signing_key: 
+rubygems_version: 3.0.9
+signing_key:
 specification_version: 4
 summary: Implements several useful developer conveniences for Middleman projects.
-test_files: []
-has_rdoc: 
+test_files:
+- features/helpers.feature
+- features/support/env.rb