octopress-tag-helpers 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 0e6606d7dc37bf5dc130e0919411b41f34441e03
+  data.tar.gz: cea488d88d622bf07273e153e65c0369c02e1d3f
+SHA512:
+  metadata.gz: 68213ec81a1b24ac4b9f511f4e07998dd062128f9e86ee9d8ab302b2b730c4e4e4afe2c1843a8a5a165a97ea9ead517f35b841c32ec34c635b8c5f4c52ddca15
+  data.tar.gz: 6b2e8d01438c4ac28d1f9f13140c2439f981d3edc90a60e2fdb1f490362b61f72c7c5612340620d70cd5ed21ca03889c1d04179861fc81f46839abbae9c013c5

data/.gitignore

@@ -0,0 +1,22 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in octopress_tag_helpers.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Brandon Mathis
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,27 @@
+# Octopress Tag Helpers
+
+This allows other Octopress tags to share helpful utility
+methods and evaluate conditionals, determine paths and evaluate
+vars in the context of a Jekyll site.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'octopress-tag-helpers'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install octopress-tag-helpers
+
+## Contributing
+
+1. Fork it ( https://github.com/octopress/tag-helpers/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request

data/Rakefile

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+

data/lib/octopress-tag-helpers/conditional.rb

@@ -0,0 +1,23 @@
+module Octopress
+  module TagHelpers
+    module Conditional
+      SYNTAX = /(.*)\s(if|unless)\s(.+)/
+
+      def self.parse(markup, context)
+        if markup =~ SYNTAX
+          case $2
+          when 'if'
+            tag = Liquid::If.new('if', $3, ["true","{% endif %}"])
+          when 'unless'
+            tag = Liquid::Unless.new('unless', $3, ["true","{% endunless %}"])
+          end
+          tag.render(context) != '' ? $1 : false
+        else
+          markup
+        end
+      end
+
+    end
+  end
+end
+

data/lib/octopress-tag-helpers/content_for.rb

@@ -0,0 +1,30 @@
+module Octopress
+  module TagHelpers
+    module ContentFor
+      def self.get_block_name(tag_name, markup)
+        if markup.strip == ''
+          raise IOError.new "Syntax Error: #{tag_name} requires a name, eg. {% #{tag_name} sidebar %}"
+        else
+          markup.strip
+        end
+      end
+
+      # Gets the storage space for the content block
+      def self.get_block(context, block)
+        context.environments.first['content_for'] ||= {}
+        context.environments.first['content_for'][block] ||= []
+      end
+
+      def self.render(context, block)
+        content = get_block(context, block).map { |b| b }.join
+      end
+
+      def self.append_to_block(context, block, content)
+        converter = context.environments.first['converter']
+        content = converter.convert(content).sub(/\n$/,'')
+        get_block(context, block) << content
+      end
+    end
+  end
+end
+

data/lib/octopress-tag-helpers/hooks.rb

@@ -0,0 +1,12 @@
+module Jekyll
+  module Convertible
+    alias_method :jekyll_do_layout, :do_layout
+
+    def do_layout(payload, layouts)
+      # The  tags needs access to the converter to process it while rendering.
+      payload['converter'] = self.converter
+
+      jekyll_do_layout(payload, layouts)
+    end
+  end
+end

data/lib/octopress-tag-helpers/path.rb

@@ -0,0 +1,47 @@
+module Octopress
+  module TagHelpers
+    module Path
+      FILE = /(\S+)(\s?)(.*)/
+      def self.parse(markup, context)
+        if markup =~ FILE
+          (context[$1].nil? ? $1 : context[$1]) + ' ' + ($3 || '')
+        else
+          markup
+        end
+      end
+
+      # Allow paths to begin from the directory of the context page or
+      # have absolute paths
+      #
+      # Input: 
+      #  - file: "file.html"
+      #  - context: A Jekyll context object
+      #
+      #  Returns the full path to a file
+      #
+      def self.expand(file, context)
+        root = context.registers[:site].source
+
+        # If relative path, e.g. ./somefile, ../somefile
+        if file =~ /^\.+\//
+          page = context['page']
+          if local_dir = page['dir']
+            File.expand_path(File.join(root, local_dir, file))
+          else
+            local_dir = File.dirname(page['path'])
+            File.expand_path(File.join(root, local_dir, file))
+          end
+
+        # If absolute or relative to a user directory, e.g. /Users/Bob/somefile or ~/somefile
+        elsif file =~ /^[\/~]/
+          File.expand_path(file)
+
+        # Otherwise, assume relative to site root
+        else
+          File.join(root, file)
+        end
+      end
+    end
+  end
+end
+

data/lib/octopress-tag-helpers/var.rb

@@ -0,0 +1,103 @@
+module Octopress
+  module TagHelpers
+    module Var
+      TERNARY = /(.*?)\(\s*(.+?)\s+\?\s+(.+?)\s+:\s+(.+?)\s*\)(.+)?/
+      HAS_FILTERS = /(.*?)(\s+\|\s+.+)/
+
+      def self.set_var(var, operator, value, context)
+        case operator
+        when '||='
+          context.scopes.last[var] = value if context.scopes.last[var].nil?
+        when '+='
+          if context.scopes.last[var].nil?
+            context.scopes.last[var] = value
+          else
+            context.scopes.last[var] += value
+          end
+        else
+          context.scopes.last[var] = value
+        end
+        context
+      end
+
+      def self.get_value(vars, context)
+        vars = evaluate_ternary(vars, context)
+        vars = vars.strip.gsub(/ or /, ' || ')
+        filters = false
+        if vars =~ HAS_FILTERS
+          vars = $1
+          filters = $2
+        end
+        vars = vars.split(/ \|\| /).map { |v|
+          context[v.strip]
+        }.compact
+
+        var = vars.first
+        if filters
+          var = Liquid::Variable.new("'#{var}'"+ filters).render(context)
+        end
+        var
+      end
+
+      def self.evaluate_ternary(markup, context)
+        if markup =~ TERNARY
+          $1 + (Conditional.parse(" if #{$2}", context) ? $3 : $4) + $5
+        else
+          markup
+        end
+      end
+
+      # Parses filters into arrays
+      #
+      # input - a string of one or more filters, e.g. "| upcase | replace:'a','b'" 
+      #
+      # Returns nested arrays of filters and arguments
+      #
+      def self.parse_filters(input)
+        output = []
+        if input.match(/#{Liquid::FilterSeparator}\s*(.*)/o)
+          filters = Regexp.last_match(1).scan(Liquid::Variable::FilterParser)
+          filters.each do |f|
+            if matches = f.match(/\s*(\w+)/)
+              filtername = matches[1]
+              filterargs = f.scan(/(?:#{Liquid::FilterArgumentSeparator}|#{Liquid::ArgumentSeparator})\s*((?:\w+\s*\:\s*)?#{Liquid::QuotedFragment})/o).flatten
+              output << [filtername, filterargs]
+            end
+          end
+        end
+        output
+      end
+
+      # Passes input through Liquid filters
+      #
+      # content - a string to be parsed
+      # filters - a series of liquid filters e.g. "| upcase | replace:'a','b'"
+      # context - the current Liquid context object
+      #
+      # Returns a filtered string
+      #
+      def self.render_filters(content, filters, context)
+        filters = parse_filters(filters)
+        return '' if content.nil?
+        filters.inject(content) do |output, filter|
+          filterargs = []
+          keyword_args = {}
+          filter[1].to_a.each do |a|
+            if matches = a.match(/\A#{Liquid::TagAttributes}\z/o)
+              keyword_args[matches[1]] = context[matches[2]]
+            else
+              filterargs << context[a]
+            end
+          end
+          filterargs << keyword_args unless keyword_args.empty?
+          begin
+            output = context.invoke(filter[0], output, *filterargs)
+          rescue
+            raise "Error - filter '#{filter[0]}' could not be found."
+          end
+        end
+      end
+    end
+  end
+end
+

data/lib/octopress-tag-helpers/version.rb

@@ -0,0 +1,5 @@
+module Octopress
+  module TagHelpers
+    VERSION = "1.0.0"
+  end
+end

data/lib/octopress-tag-helpers.rb

@@ -0,0 +1,11 @@
+require "octopress-tag-helpers/version"
+require "octopress-tag-helpers/hooks"
+
+module Octopress
+  module TagHelpers
+    autoload :Conditional,            'octopress-tag-helpers/conditional'
+    autoload :ContentFor,             'octopress-tag-helpers/content_for'
+    autoload :Path,                   'octopress-tag-helpers/path'
+    autoload :Var,                    'octopress-tag-helpers/var'
+  end
+end

data/octopress-tag-helpers.gemspec

@@ -0,0 +1,25 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'octopress-tag-helpers/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "octopress-tag-helpers"
+  spec.version       = Octopress::TagHelpers::VERSION
+  spec.authors       = ["Brandon Mathis"]
+  spec.email         = ["brandon@imathis.com"]
+  spec.summary       = %q{Making it easier to build smart Jekyll/Octopress Liquid tags.}
+  spec.description   = %q{Making it easier to build smart Jekyll/Octopress Liquid tags.}
+  spec.homepage      = "https://github.com/octopress/tag-helpers"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_runtime_dependency "jekyll", "~> 2.0"
+
+  spec.add_development_dependency "bundler", "~> 1.6"
+  spec.add_development_dependency "rake"
+end

metadata

@@ -0,0 +1,99 @@
+--- !ruby/object:Gem::Specification
+name: octopress-tag-helpers
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Brandon Mathis
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-06-29 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: jekyll
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        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: 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: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Making it easier to build smart Jekyll/Octopress Liquid tags.
+email:
+- brandon@imathis.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/octopress-tag-helpers.rb
+- lib/octopress-tag-helpers/conditional.rb
+- lib/octopress-tag-helpers/content_for.rb
+- lib/octopress-tag-helpers/hooks.rb
+- lib/octopress-tag-helpers/path.rb
+- lib/octopress-tag-helpers/var.rb
+- lib/octopress-tag-helpers/version.rb
+- octopress-tag-helpers.gemspec
+homepage: https://github.com/octopress/tag-helpers
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Making it easier to build smart Jekyll/Octopress Liquid tags.
+test_files: []