forematter 0.1.0

data/CHANGELOG.md

@@ -0,0 +1,3 @@
+# v0.1.0
+
+ * Initial release

data/CONTRIBUTING.md

@@ -0,0 +1,9 @@
+# Contributing
+
+_You_ can make Forematter even awesomer!
+
+1. [Fork Forematter](https://github.com/bobthecow/forematter/fork)
+2. Create your feature branch: `git checkout -b feature/awesomesauce`
+3. Commit your changes: `git commit -am 'Add awesomesauce feature'`
+4. Push to the branch: `git push origin feature/awesomesauce`
+5. [Submit a new Pull Request](http://help.github.com/send-pull-requests/)!

data/LICENSE.md

@@ -0,0 +1,20 @@
+The MIT License (MIT)
+Copyright (c) 2013 Justin Hileman
+
+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,126 @@
+# Forematter
+
+Forematter is the frontmatter-aware friend for your static site.
+
+
+## Install Forematter
+
+Add this line to your application's Gemfile:
+
+```rb
+gem 'forematter'
+```
+
+And then execute:
+
+```bash
+$ bundle
+```
+
+Or install it yourself, if that's what you're into:
+
+```bash
+$ gem install forematter
+```
+
+If you're not running a Ruby version manager, you might need to use `sudo gem install forematter` instead. But try it without the `sudo` first.
+
+
+## Use Forematter for Good
+
+Forematter makes it easy to add tags I forgot:
+
+```bash
+$ find . -name "*twitter*.markdown" | xargs fore add tags twitter
+```
+
+And find all of my dumb:
+
+```bash
+$ find . -name "*twitter*.markdown" | xargs fore list tags | grep -i tw
+```
+
+> Twitpocalypse  
+> Twitter  
+> twitter
+
+... whoops. Let's fix that:
+
+```bash
+$ fore merge tags Twitter twitter *.markdown
+$ find . -name "*twitter*.markdown" | xargs fore list tags | grep -i tw
+```
+
+> Twitpocalypse  
+> Twitter
+
+Much better!
+
+
+## Use Forematter for Awesome
+
+Forematter lets me automatically categorize all my blog posts, based on the tags I use:
+
+```bash
+# Grab the 10 most common tags from my blog
+for c in $(fore count tags *.markdown | tail -10 | sort -r | awk '{print($2)}'); do
+  # Set the category on each article with one of these tags
+  fore search -l tags "$c" *.markdown | xargs fore set category "$c"
+end
+
+# Format categories as title case
+fore cleanup category --titlecase *.markdown
+
+# Automatically classify all articles which don't already have a category
+fore classify category *.markdown
+```
+
+It does a lot more, too:
+
+```bash
+fore add      tags   foo bar       content/*.md
+fore remove   tags   bacon         content/*.md
+fore merge    tags   foo Foo       content/*.md
+fore count    tags                 content/*.md
+fore search   tags                 content/*.md
+fore list     tags                 content/*.md
+
+fore set      title  'title!'      content/foo.md
+fore unset    title                content/bar.md
+fore list     title                content/*.md
+
+fore touch    updated_at           content/baz.md
+
+fore cleanup  title --titlecase    content/*.md
+fore cleanup  name  --capitalize   content/*.md
+fore cleanup  tags  --downcase     content/*.md
+fore cleanup  slug  --url          content/*.md
+fore cleanup  title --trim         content/*.md
+fore cleanup  tags  --sort         content/*.md
+
+fore classify category             content/*.md
+fore classify category --override  content/*.md
+
+fore --help
+```
+
+
+## Use it in your shell
+
+Forematter tries to be a good *nix citizen. It plays nice with `find` and `grep` and `awk`. Mix and match with all your favorite command line tools!
+
+
+## Use it everywhere
+
+Forematter isn't tied to any particular static site generator. If your files have [YAML frontmatter](http://jekyllrb.com/docs/frontmatter/), Forematter is the tool for you.
+
+If you're looking for a great static site generator, go [check out this list — 210 of 'em and counting](http://staticsitegenerators.net)!
+
+If Forematter doesn't work with your favorite, [let us know](https://github.com/bobthecow/forematter/issues/new).
+
+
+## Buyer beware
+
+Forematter works by _editing your site's content files_. There is a nonzero chance that you'll do something you regret, and Forematter can't help you ⌘Z.
+
+If you're not keeping things under version control, this would be a good time to start!

data/Rakefile

@@ -0,0 +1,3 @@
+# encoding: utf-8
+
+require 'bundler/gem_tasks'

data/bin/fore

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+# encoding: utf-8
+
+# Trap interrupts to quit cleanly while booting.
+Signal.trap('INT') { exit 1 }
+
+require 'forematter'
+
+begin
+  Forematter.run(ARGV)
+rescue Interrupt
+  $stderr.puts 'Quitting'
+  exit 1
+end

data/forematter.gemspec

@@ -0,0 +1,29 @@
+# encoding: utf-8
+
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'forematter/version'
+
+Gem::Specification.new do |spec|
+  spec.name        = 'forematter'
+  spec.version     = Forematter::VERSION.gsub('-', '.')
+  spec.authors     = ['Justin Hileman']
+  spec.email       = 'justin@justinhileman.info'
+  spec.homepage    = 'https://github.com/bobthecow/forematter'
+  spec.summary     = 'the frontmatter-aware friend for your static site'
+  spec.description = 'Forematter is the frontmatter-aware friend for your static site'
+  spec.license     = 'MIT'
+
+  spec.files  = %w(CHANGELOG.md CONTRIBUTING.md LICENSE.md README.md Rakefile forematter.gemspec)
+  spec.files += Dir['lib/**/*.rb']
+  spec.files += Dir['spec/**/*.rb']
+
+  spec.executables  = %w(fore)
+
+  spec.add_dependency 'cri', '~> 2.4'
+  spec.add_dependency 'stringex'
+  spec.add_dependency 'titleize'
+
+  spec.add_development_dependency 'bundler'
+  spec.add_development_dependency 'rake'
+end

data/lib/forematter/command_runner.rb

@@ -0,0 +1,67 @@
+# encoding: utf-8
+
+module Forematter
+  class CommandRunner < ::Cri::CommandRunner
+    def call
+      run
+    rescue UsageException
+      path = [command.supercommand]
+      path.unshift(path[0].supercommand) until path[0].nil?
+      super_usage = path[1..-1].map { |c| c.name + ' ' }.join
+      $stderr.puts "usage: #{super_usage}#{command.usage}"
+      exit 1
+    end
+
+    protected
+
+    def field
+      partition
+      fail UsageException, 'Missing field name' unless @field
+      @field
+    end
+
+    def value
+      fail 'ARGS!' unless command.value_args == :one
+      partition
+      fail UsageException, 'Missing argument' unless @value
+      @value
+    end
+
+    def values
+      fail 'ARGS!' unless command.value_args == :many
+      partition
+      fail UsageException, 'Missing argument' if @values.empty?
+      @values
+    end
+
+    def files
+      partition
+      fail UsageException, 'No file(s) specified' if @files.empty?
+      @files
+    end
+
+    def files_with(key)
+      files.select { |f| f.key?(key) }
+    end
+
+    def partition
+      return if @args_partitioned
+      args = arguments.dup
+      @field = args.shift
+      @value = args.shift               if command.value_args == :one
+      @values, args = guess_split(args) if command.value_args == :many
+      @files = args.map { |f| Forematter::FileWrapper.new(f) }
+      @args_partitioned = true
+    end
+
+    def guess_split(args)
+      if (i = args.index('--'))
+        [args[0..i], args[i..-1]]
+      else
+        files = []
+        files.unshift(args.pop) while !args.empty? && File.exist?(args.last)
+        [args, files]
+      end
+    end
+  end
+end

data/lib/forematter/commands/add.rb

@@ -0,0 +1,33 @@
+# encoding: utf-8
+
+value_args  :many
+summary     'add values to a field'
+description <<-EOS
+Add values to a frontmatter field in to a set of files.
+
+By default, values will only be added if they don't already exist in a set. This
+can be overridden with `--allow-dupes`.
+
+If the specified frontmatter field is present on a file, but the value isn't a
+YAML sequence (array), `fore add` will exit with an error.
+EOS
+
+flag nil, :'allow-dupes', 'allow duplicate values'
+
+module Forematter::Commands
+  class Add < Forematter::CommandRunner
+    def run
+      files.each do |file|
+        old = file[field].to_ruby || []
+        fail "#{field} is not an array" unless old.is_a?(Array)
+        add = options[:'allow-dupes'] ? values : values.select { |v| !old.include?(v) }
+        next if add.empty?
+        add.each { |v| old << v }
+        file[field] = old
+        file.write
+      end
+    end
+  end
+end
+
+runner Forematter::Commands::Add

data/lib/forematter/commands/classify.rb

@@ -0,0 +1,80 @@
+# encoding: utf-8
+
+value_args  :none
+aliases     :categorize
+summary     'classify files by the given field'
+description <<-EOS
+Classify a set of files by the given frontmatter field.
+
+For example, automatic classification could be used to select categories for
+articles or blog posts:
+
+    fore classify category articles/*.md
+
+By default, files which already have a value for the given field are used to
+train the classifier, and files without a value are automatically classified.
+
+If the `--override` option is passed, the classifier will be trained on the
+available files as usual, and every file will be re-classified.
+
+If the given frontmatter field is present on a file, but the value isn't a
+string, `fore classify` will exit with an error.
+EOS
+
+flag nil, :override, 'Override existing values'
+
+module Forematter::Commands
+  class Classify < Forematter::CommandRunner
+    def run
+      load_classifier
+
+      puts 'Getting categories'
+      categories_for(files_with(field)).each do |cat|
+        bayes.add_category(cat.to_sym)
+      end
+
+      puts 'Training classifier'
+      files_with(field).each { |file| train(file) }
+
+      puts 'Classifying files'
+      files_to_classify.each { |file| file.write if classify(file) }
+    end
+
+    protected
+
+    def load_classifier
+      require 'classifier'
+    rescue LoadError
+      $stderr.puts 'Install "classifier" gem to generate suggestions'
+      exit 1
+    end
+
+    def bayes
+      @bayes ||= Classifier::Bayes.new
+    end
+
+    def categories_for(files)
+      files.map { |file| file[field].to_ruby }.reject(&:nil?).uniq
+    end
+
+    def files_to_classify
+      files.reject do |file|
+        file.key?(field) unless options[:override]
+      end
+    end
+
+    def train(file)
+      val = file[field].to_ruby
+      fail 'Unable to classify by non-string fields' unless val.is_a?(String)
+      bayes.train(val.to_sym, file.content)
+    end
+
+    def classify(file)
+      old = file[field].to_ruby
+      file[field] = bayes.classify(file.content).to_s
+      file[field].to_ruby != old
+    end
+  end
+end
+
+runner Forematter::Commands::Classify

data/lib/forematter/commands/cleanup.rb

@@ -0,0 +1,67 @@
+# encoding: utf-8
+
+value_args  :none
+summary     'clean up a field'
+description <<-EOS
+Normalize values in a frontmatter field in a set of files.
+
+If the given frontmatter field is present on a file, but the value isn't a
+string, `fore cleanup --sort` will exit with an error.
+EOS
+
+flag nil, :downcase,   'change to lower case'
+flag nil, :capitalize, 'change to sentence case'
+flag nil, :titlecase,  'change to title case'
+flag nil, :sort,       'sort field values'
+# flag nil, :translit,   'transliterate values'
+flag nil, :trim,       'trim whitespace'
+flag nil, :url,        'sluggify'
+
+module Forematter::Commands
+  class Cleanup < Forematter::CommandRunner
+    def run
+      require 'stringex_lite'
+      require 'titleize'
+
+      files_with(field).each do |file|
+        old = file[field].to_ruby
+        val = cleanup(old)
+        unless val == old
+          file[field] = val
+          file.write
+        end
+      end
+    end
+
+    protected
+
+    CLEANUP_MAP = {
+      downcase:   :downcase,
+      capitalize: :capitalize,
+      titlecase:  :titleize,
+      # translit:   :translit,
+      trim:       :strip,
+      url:        :to_url,
+    }
+
+    def cleanup(val)
+      val = val.dup
+      return cleanup_array(val) if val.is_a?(Array)
+      fail 'Unable to sort non-array values' if options[:sort]
+      options.keys.each do |option|
+        val = val.method(CLEANUP_MAP[option]).call if CLEANUP_MAP.key?(option) && options[option]
+      end
+      val
+    end
+
+    def cleanup_array(val)
+      options.keys.each do |option|
+        val.map!(&CLEANUP_MAP[option]) if CLEANUP_MAP.key?(option) && options[option]
+      end
+      val.sort_by!(&:downcase) if options[:sort]
+      val
+    end
+  end
+end
+
+runner Forematter::Commands::Cleanup

data/lib/forematter/commands/count.rb

@@ -0,0 +1,32 @@
+# encoding: utf-8
+
+value_args  :none
+summary     'count values in a field'
+description <<-EOS
+Count the number of times each value of a given field appears in a set of files.
+EOS
+
+module Forematter::Commands
+  class Count < Forematter::CommandRunner
+    def run
+      counts = tags.reduce({}) { |a, e| a.merge(e => (a[e] || 0) + 1) }
+      fmt    = format(counts)
+
+      counts.sort_by { |tag, count| count }.each do |tag, count|
+        puts sprintf(fmt, count, tag)
+      end
+    end
+
+    protected
+
+    def tags
+      files_with(field).map { |file| file[field].to_ruby }.flatten.map(&:to_sym)
+    end
+
+    def format(counts)
+      "%#{counts.values.max.to_s.length}d %s"
+    end
+  end
+end
+
+runner Forematter::Commands::Count

data/lib/forematter/commands/fore.rb

@@ -0,0 +1,22 @@
+# encoding: utf-8
+
+usage   'fore command [options] [arguments]'
+summary 'Forematter, the frontmatter-aware friend for your static site'
+
+flag :h, :help, 'show the help message and quit' do |value, cmd|
+  puts cmd.help
+  exit 0
+end
+
+# flag :V, :verbose, 'enable verbose output' do
+#   Forematter.verbose = true
+# end
+
+flag :v, :version, 'show version' do
+  puts Forematter::VERSION
+  exit 0
+end
+
+run do |opts, args, cmd|
+  puts cmd.help
+end

data/lib/forematter/commands/list.rb

@@ -0,0 +1,24 @@
+# encoding: utf-8
+
+value_args  :none
+aliases     :ls
+summary     'list values for a field'
+description <<-EOS
+List the values for a given frontmatter field in a set of files.
+EOS
+
+module Forematter::Commands
+  class List < Forematter::CommandRunner
+    def run
+      puts tags.uniq.sort_by(&:downcase).join("\n")
+    end
+
+    protected
+
+    def tags
+      files_with(field).map { |file| file[field].to_ruby }.flatten
+    end
+  end
+end
+
+runner Forematter::Commands::List

data/lib/forematter/commands/merge.rb

@@ -0,0 +1,34 @@
+# encoding: utf-8
+
+value_args  :many
+summary     'combine multiple values for a field'
+description <<-EOS
+Combine multiple values for a frontmatter field in a set of files.
+
+If the given frontmatter field is present on a file, but the value isn't a
+string, `fore merge` will exit with an error.
+EOS
+
+module Forematter::Commands
+  class Merge < Forematter::CommandRunner
+    def run
+      dups      = values.dup
+      canonical = dups.shift
+
+      files_with(field).each do |file|
+        old = file[field].to_ruby
+        fail "#{field} is not an array" unless old.is_a?(Array)
+
+        # Continue unless unless field had one of the values to remove
+        next if (old & dups).empty?
+        dups.each { |v| file[field].delete(v) }
+
+        # Save the original canonical for later
+        file[field] << canonical unless file[field].include?(canonical)
+        file.write
+      end
+    end
+  end
+end
+
+runner Forematter::Commands::Merge

data/lib/forematter/commands/remove.rb

@@ -0,0 +1,30 @@
+# encoding: utf-8
+
+value_args  :many
+aliases     :rm
+summary     'remove values from a field'
+description <<-EOS
+Remove values from a frontmatter field in a set of files.
+
+If the given frontmatter field is present on a file, but the value isn't a
+string, `fore remove` will exit with an error.
+EOS
+
+module Forematter::Commands
+  class Remove < Forematter::CommandRunner
+    def run
+      files_with(field).each do |file|
+        old = file[field].to_ruby
+        fail "#{field} is not an array" unless old.is_a?(Array)
+
+        # Continue unless old contains elements of values
+        next if (old & values).empty?
+        values.each { |v| file[field].delete(v) }
+
+        file.write
+      end
+    end
+  end
+end
+
+runner Forematter::Commands::Remove

data/lib/forematter/commands/rename.rb

@@ -0,0 +1,21 @@
+# encoding: utf-8
+
+value_args  :one
+aliases     :mv
+summary     'rename a field'
+description <<-EOS
+Rename a frontmatter field in a set of files.
+EOS
+
+module Forematter::Commands
+  class Rename < Forematter::CommandRunner
+    def run
+      files_with(field).each do |file|
+        file.rename(field, value)
+        file.write
+      end
+    end
+  end
+end
+
+runner Forematter::Commands::Rename

data/lib/forematter/commands/search.rb

@@ -0,0 +1,62 @@
+# encoding: utf-8
+
+value_args  :one
+value_name  'pattern'
+summary     'search for values in a field'
+description <<-EOS
+Search for values for a given frontmatter field in a set of files.
+
+The search pattern may be a string or regular expression, e.g. `/foo\.bar/`.
+EOS
+
+flag :i,  :'ignore-case',        'perform case insensitive matching'
+flag :l,  :'files-with-matches', 'only list the names of files with matches'
+flag nil, :print0,               'list file names followed by an ASCII NUL character (for use with `xargs -0`)'
+
+module Forematter::Commands
+  class Search < Forematter::CommandRunner
+    def run
+      files_with(field).sort_by(&:filename).each do |file|
+        field_val = file[field].to_ruby
+        if field_val.is_a? Array
+          next unless field_val.any? { |v| pattern =~ v }
+        else
+          next unless pattern =~ field_val
+        end
+        write(file.filename, field_val)
+      end
+    end
+
+    protected
+
+    def write(filename, val)
+      if options[:print0]
+        print "#{filename}\0"
+      elsif options[:'files-with-matches']
+        puts filename
+      else
+        puts "#{filename}: #{val.to_json}"
+      end
+    end
+
+    def pattern
+      @pattern ||= parse_pattern
+    end
+
+    def parse_pattern
+      opts = options[:'ignore-case'] ? Regexp::IGNORECASE : 0
+
+      if %r{^/(.*)/([im]{0,2})$} =~ value
+        val = Regexp.last_match[1]
+        opts |= Regexp::IGNORECASE if Regexp.last_match[2].include? 'i'
+        opts |= Regexp::MULTILINE  if Regexp.last_match[2].include? 'm'
+      else
+        val = Regexp.escape(value)
+      end
+
+      Regexp.new(val, opts)
+    end
+  end
+end
+
+runner Forematter::Commands::Search

data/lib/forematter/commands/set.rb

@@ -0,0 +1,29 @@
+# encoding: utf-8
+
+value_args  :one
+summary     'set a field value'
+description <<-EOS
+Set a frontmatter field value on a set of files.
+EOS
+
+module Forematter::Commands
+  class Set < Forematter::CommandRunner
+    def run
+      files.each do |file|
+        file[field] = value
+        file.write
+      end
+    end
+
+    protected
+
+    def value
+      val = super
+      YAML.load(val)
+    rescue Psych::SyntaxError
+      val
+    end
+  end
+end
+
+runner Forematter::Commands::Set

data/lib/forematter/commands/suggest.rb

@@ -0,0 +1,53 @@
+# encoding: utf-8
+
+value_args  :none
+summary     'suggest values for a field'
+description <<-EOS
+Suggest values for a given frontmatter field based on other files in a set.
+EOS
+
+flag nil, :override, 'Override existing values'
+
+module Forematter::Commands
+  class Suggest < Forematter::CommandRunner
+    def run
+      load_classifier
+
+      # Seed LSI index
+      files_with(field).each { |file| seed_index(file) }
+
+      # This takes days:
+      puts 'Building index... eesh'
+      lsi.build_index
+      puts "And we're done!"
+
+      files.each { |file| get_recs(file) }
+    end
+
+    protected
+
+    def load_classifier
+      require 'classifier'
+    rescue LoadError
+      $stderr.puts 'Install "classifier" gem to generate suggestions'
+      exit 1
+    end
+
+    def lsi
+      @lsi ||= Classifier::LSI.new(auto_rebuild: false)
+    end
+
+    def seed_index(file)
+      return unless file[:meta].key?(field)
+      lsi.add_item file[:file], *file[:meta][field].to_ruby { |i| file[:content] }
+    end
+
+    def get_recs(file)
+      return if file[:meta].key?(field) unless options[:override]
+
+      # TODO: something here :)
+    end
+  end
+end
+
+runner Forematter::Commands::Suggest

data/lib/forematter/commands/touch.rb

@@ -0,0 +1,65 @@
+# encoding: utf-8
+
+value_args  :none
+summary     'update a field timestamp'
+
+i = "\xC2\xA0" * 4
+description <<-EOS
+Update a frontmatter field timestamp for a set of files.
+
+The new defaults to the current time, but may be overridden by passing
+`--time`.
+
+By default, an ISO-8601 string is used. Alternate formats may be specified:
+
+--format iso8601
+
+#{i}ISO-8601 date format, e.g. 2001-02-03T04:05:06+07:00 (default)
+
+--format date
+
+#{i}A YAML date literal.
+
+--format db
+
+#{i}ANSI SQL date format, e.g. 2001-02-03 04:05:06
+
+--format '%Y-%m-%d'
+
+#{i}Or any valid strftime format string
+EOS
+
+required :t, :time,   'new timestamp value (default: now)'
+required :f, :format, 'timestamp format (default: iso8601)'
+
+module Forematter::Commands
+  class Touch < Forematter::CommandRunner
+    def run
+      files_with(field).each do |file|
+        file[field] = now
+        file.write
+      end
+    end
+
+    protected
+
+    def now
+      @now ||= format_now
+    end
+
+    def format_now
+      format = options[:format] || 'iso8601'
+      now    = options.key?(:time) ? Time.new(options[:time]) : Time.now
+
+      case format
+      when 'date'    then now
+      when 'iso8601' then now.to_datetime.iso8601
+      when 'db'      then now.strftime('%Y-%m-%d %H:%M:%S')
+      else
+        now.strftime(format)
+      end
+    end
+  end
+end
+
+runner Forematter::Commands::Touch

data/lib/forematter/commands/unset.rb

@@ -0,0 +1,20 @@
+# encoding: utf-8
+
+value_args  :none
+summary     'remove a field'
+description <<-EOS
+Remove a frontmatter field from a set of files.
+EOS
+
+module Forematter::Commands
+  class Unset < Forematter::CommandRunner
+    def run
+      files_with(field).each do |file|
+        file.delete(field)
+        file.write
+      end
+    end
+  end
+end
+
+runner Forematter::Commands::Unset

data/lib/forematter/core_ext.rb

@@ -0,0 +1,47 @@
+# encoding: utf-8
+
+fail 'Forematter requires Psych' unless defined?(Psych)
+
+# class String
+#   def translit
+#     convert_smart_punctuation.
+#       convert_accented_html_entities.
+#       convert_vulgar_fractions.
+#       convert_miscellaneous_html_entities.
+#       convert_miscellaneous_characters.
+#       to_ascii.
+#       convert_miscellaneous_characters.
+#       collapse
+#   end
+# end
+
+module Psych::Nodes
+  class Sequence
+    def include?(val)
+      children.any? { |c| c.to_ruby == val }
+    end
+
+    def delete(val)
+      return unless include?(val)
+      children.each_index do |i|
+        return children.delete_at(i) if children[i].to_ruby == val
+      end
+    end
+
+    def [](index)
+      fail "Unexpected index: #{index}" unless index.is_a? Integer
+      children[index]
+    end
+
+    def []=(index = nil, val)
+      return push(val) if index.nil?
+      fail "Unexpected index: #{index}" unless index.is_a? Integer
+      children[index] = YAML.parse(YAML.dump(val)).children.first
+    end
+
+    def push(val)
+      children.push(YAML.parse(YAML.dump(val)).children.first)
+    end
+    alias_method :<<, :push
+  end
+end

data/lib/forematter/cri_ext.rb

@@ -0,0 +1,33 @@
+# encoding: utf-8
+
+module Cri
+  class Command
+    attr_accessor :value_args
+    attr_accessor :value_name
+  end
+
+  class CommandDSL
+    def value_args(count)
+      @command.value_args = count
+    end
+
+    def value_name(name)
+      @command.value_name = name
+    end
+
+    NBSP = "\xC2\xA0"
+
+    def auto_usage
+      name  = @command.name
+      value = @command.value_name || 'value'
+      case @command.value_args
+      when :none
+        usage "#{name} [options] field file [file#{NBSP}...]"
+      when :one
+        usage "#{name} [options] field #{value} file [file#{NBSP}...]"
+      when :many
+        usage "#{name} [options] field #{value} [#{value}#{NBSP}...] file [file#{NBSP}...]"
+      end
+    end
+  end
+end

data/lib/forematter/file_wrapper.rb

@@ -0,0 +1,51 @@
+# encoding: utf-8
+
+module Forematter
+  class FileWrapper
+    extend Forwardable
+
+    def initialize(filename)
+      fail "File not found: #{filename}" unless File.exist?(filename)
+      @filename = filename
+    end
+
+    attr_reader :filename
+
+    def_delegators :meta, :key?, :has_key?, :[], :[]=, :delete, :rename
+
+    def to_s
+      "#{meta.to_yaml}---\n#{content}"
+    end
+
+    def write
+      File.open(filename, 'w+') { |f| f << to_s }
+    end
+
+    def content
+      parse_file
+      @content
+    end
+
+    protected
+
+    def meta
+      parse_file
+      @meta
+    end
+
+    def parse_file
+      return if @is_parsed
+
+      data    = '--- {}'
+      content = IO.read(@filename)
+      if content =~ /\A(---\s*\n.*?\n?)^(?:(?:---|\.\.\.)\s*$\n?)/m
+        data    = Regexp.last_match[1]
+        content = $POSTMATCH
+      end
+
+      @meta      = Forematter::Frontmatter.new(data)
+      @content   = content
+      @is_parsed = true
+    end
+  end
+end

data/lib/forematter/frontmatter.rb

@@ -0,0 +1,90 @@
+# encoding: utf-8
+
+module Forematter
+  class Frontmatter
+    def initialize(input)
+      init_stream(input)
+    end
+
+    def key?(key)
+      data.children.each_index do |i|
+        next unless i % 2
+        return true if data.children[i].to_ruby == key
+      end
+
+      false
+    end
+    alias_method :has_key?, :key?
+
+    def [](key)
+      data.children.each_index do |i|
+        next unless i % 2
+        return data.children[i + 1] if data.children[i].to_ruby == key
+      end
+      nil
+    end
+
+    def []=(key, val)
+      data.children.each_index do |i|
+        next unless i % 2
+        if data.children[i].to_ruby == key
+          data.children[i + 1] = thunk(val, data.children[i + 1])
+          return
+        end
+      end
+
+      data.children << Psych::Nodes::Scalar.new(key)
+      data.children << thunk(val)
+    end
+
+    def delete(key)
+      data.children.each_index do |i|
+        next unless i % 2
+        if data.children[i].to_ruby == key
+          val = data.children.delete_at(i + 1)
+          data.children.delete_at(i)
+          return val
+        end
+      end
+    end
+
+    def rename(key, new_key)
+      data.children.each_index do |i|
+        next unless i % 2
+        if data.children[i].to_ruby == key
+          data.children[i].value = new_key
+          return
+        end
+      end
+    end
+
+    def to_yaml
+      @stream.to_yaml
+    end
+
+    protected
+
+    def thunk(val, old = nil)
+      return val if val.is_a?(Psych::Nodes::Node)
+      val = parse_yaml(val)
+      if old.is_a?(Psych::Nodes::Sequence) && val.is_a?(Psych::Nodes::Sequence)
+        old.children.replace(val.children)
+        val = old
+      end
+      val
+    end
+
+    def parse_yaml(val)
+      YAML.parse(YAML.dump(val)).children.first
+    end
+
+    attr_reader :data
+
+    def init_stream(input)
+      doc = YAML.parse_stream(input).children.first
+      @data = doc.children.first
+      @stream = YAML.parse_stream('')
+      @stream.children << doc
+    end
+  end
+end

data/lib/forematter/version.rb

@@ -0,0 +1,5 @@
+# encoding: utf-8
+
+module Forematter
+  VERSION = '0.1.0'
+end

data/lib/forematter.rb

@@ -0,0 +1,68 @@
+# encoding: utf-8
+
+# stdlib
+require 'date'
+require 'English'
+require 'forwardable'
+require 'yaml'
+require 'json'
+
+# third party
+require 'cri'
+
+# forematter
+require 'forematter/version'
+require 'forematter/core_ext'
+require 'forematter/cri_ext'
+require 'forematter/frontmatter'
+require 'forematter/file_wrapper'
+require 'forematter/command_runner'
+
+module Forematter
+  module Commands
+  end
+
+  class UsageException < Exception
+  end
+
+  class << self
+    attr_reader   :root_command
+    # attr_accessor :verbose
+
+    def run(args)
+      # Remove the signal trap we set in the bin file.
+      Signal.trap('INT', 'DEFAULT')
+      setup
+      root_command.run(args)
+    end
+
+    def add_command(cmd)
+      root_command.add_command(cmd)
+    end
+
+    protected
+
+    def setup
+      root_cmd_filename = File.dirname(__FILE__) + '/forematter/commands/fore.rb'
+
+      # Add help and root commands
+      @root_command = load_command_at(root_cmd_filename)
+      add_command(Cri::Command.new_basic_help)
+
+      cmd_filenames.each do |filename|
+        add_command(load_command_at(filename)) unless filename == root_cmd_filename
+      end
+    end
+
+    def cmd_filenames
+      Dir[File.dirname(__FILE__) + '/forematter/commands/*.rb']
+    end
+
+    def load_command_at(filename, command_name = nil)
+      Cri::Command.define(File.read(filename), filename).modify do
+        name command_name || File.basename(filename, '.rb')
+        auto_usage
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,160 @@
+--- !ruby/object:Gem::Specification
+name: forematter
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- Justin Hileman
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-12-12 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: cri
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.4'
+- !ruby/object:Gem::Dependency
+  name: stringex
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: titleize
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Forematter is the frontmatter-aware friend for your static site
+email: justin@justinhileman.info
+executables:
+- fore
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- CONTRIBUTING.md
+- LICENSE.md
+- README.md
+- Rakefile
+- forematter.gemspec
+- lib/forematter/command_runner.rb
+- lib/forematter/commands/add.rb
+- lib/forematter/commands/classify.rb
+- lib/forematter/commands/cleanup.rb
+- lib/forematter/commands/count.rb
+- lib/forematter/commands/fore.rb
+- lib/forematter/commands/list.rb
+- lib/forematter/commands/merge.rb
+- lib/forematter/commands/remove.rb
+- lib/forematter/commands/rename.rb
+- lib/forematter/commands/search.rb
+- lib/forematter/commands/set.rb
+- lib/forematter/commands/suggest.rb
+- lib/forematter/commands/touch.rb
+- lib/forematter/commands/unset.rb
+- lib/forematter/core_ext.rb
+- lib/forematter/cri_ext.rb
+- lib/forematter/file_wrapper.rb
+- lib/forematter/frontmatter.rb
+- lib/forematter/version.rb
+- lib/forematter.rb
+- bin/fore
+homepage: https://github.com/bobthecow/forematter
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 2379320938142761946
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 2379320938142761946
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: the frontmatter-aware friend for your static site
+test_files: []