middlemac-extras 1.0.6 → 1.0.7

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.7
 platform: ruby
 authors:
 - Jim Derry
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-04-08 00:00:00.000000000 Z
+date: 2016-05-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: middleman-core
@@ -19,7 +19,7 @@ dependencies:
         version: '4.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 4.1.6
+        version: 4.1.7
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '4.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 4.1.6
+        version: 4.1.7
 - !ruby/object:Gem::Dependency
   name: middleman-cli
   requirement: !ruby/object:Gem::Requirement
@@ -39,7 +39,7 @@ dependencies:
         version: '4.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 4.1.6
+        version: 4.1.7
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -49,27 +49,83 @@ dependencies:
         version: '4.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 4.1.6
+        version: 4.1.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.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.9.0
-  type: :runtime
+        version: 4.1.7
+  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.9'
+        version: '4.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 4.1.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: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.9.0
+        version: '0'
 description: Implements several useful developer conveniences for Middleman projects.
 email:
 - balthisar@gmail.com
@@ -79,6 +135,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".gitignore"
+- ".yardopts"
 - CHANGELOG.md
 - Gemfile
 - LICENSE.md
@@ -89,6 +146,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,15 +184,34 @@ 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
@@ -155,9 +232,11 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.8
+rubygems_version: 2.5.1
 signing_key: 
 specification_version: 4
 summary: Implements several useful developer conveniences for Middleman projects.
-test_files: []
+test_files:
+- features/helpers.feature
+- features/support/env.rb
 has_rdoc: