mr_poole 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 30428d35eafd9d58388483a2a69f299e7014f89a
+  data.tar.gz: b1f25c5ba6677ddc1568f3d62310a751f0a6b68a
+SHA512:
+  metadata.gz: 83cbc63e84de3ac30014a48b4ba1d376ea12add90644c3c320d9456737d26931a03050f09b38cbd1b1f642b20da5f654740e2b286d0e0cf24e423c8e4c0b30b1
+  data.tar.gz: 0bc63bef197d7b5d5d5e4f9a8840e9faaf42aab26f0fbdd2b2ff334380d50ac1b6b5b51dd0debdf0c161fcc330606165e2d62d6a7a88634f3a757581ba6a36a0

data/.gitignore

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

data/Gemfile

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

data/LICENSE

@@ -0,0 +1,20 @@
+The MIT License (MIT)
+
+Copyright (c) 2013 Michael McClimon
+
+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,131 @@
+# Mr. Poole
+
+A butler for Jekyll. Provides a command-line interface (called `poole`) for
+creating and publishing posts and drafts for [Jekyll](http://jekyllrb.com)
+blogs.
+
+The literary Mr. Poole is Jekyll's butler, who "serves Jekyll faithfully, and
+attempts to do a good job and be loyal to his master"
+[Wikipedia](http://en.wikipedia.org/wiki/Jekyll_and_hyde#Mr._Poole), and the
+Mr. Poole gem looks to be the same thing.
+
+## Usage
+
+Mr. Poole is primarily a command-line application: the gem installs an
+executable called `poole` in your path. It has four subcommands: post, draft,
+publish, and unpublish.
+
+### Post
+
+    poole post [OPTIONS] TITLE
+
+Generates a timestamped post in your `_posts` directory, with the format
+`YYYY-MM-DD-slug.md` (other formats to be suppored in the future). With no
+options, will generate a slug based on your title by replacing spaces with
+underscores, downcasing, and removing any special character. With option
+`--slug` (or `-s`), you can provide a custom slug.
+
+Poole generates a simple file (in the future, this will be customizable) that
+looks like this:
+
+```yaml
+---
+title: (your title automatically inserted here)
+layout: post
+date: (current date automatically inserted here)
+---
+```
+
+### Draft
+
+    poole draft [OPTIONS] TITLE
+
+Just like `poole post`, except that it creates an untimestamped post in your
+`_drafts` directory (creating it if it doesn't exist yet). Also takes
+`--slug`/`-s` as an option. In the generated file, no date is inserted.
+
+### Publish
+
+    poole publish DRAFT_PATH
+
+Publishes a draft from your _drafts folder to your _posts folder, renaming the
+file and updating the date in the header.
+
+Given this file (called `_drafts/test_draft.md`):
+
+```
+---
+title: My awesome blog post
+layout: post
+date:
+---
+
+The life, universe, and everything.
+```
+
+A call to `poole publish` will generate a file named
+`_posts/yyyy-mm-dd-test_draft.md` and delete the draft. (TODO: add flags for
+no-delete drafts, and no-update timstamp.) Also updates the date filed in the
+header with a date, and HH:MM, producing this file:
+
+```
+---
+title: My awesome blog post
+layout: post
+date: 2010-01-02 16:00
+---
+
+The life, universe, and everything.
+```
+
+### Unpublish
+
+    poole unpublish POST_PATH
+
+The reverse of publish: moves a file from your _posts folder to the _drafts
+folder, renaming the file and removing the date in the header. This will
+rename a file called `_posts/yyyy-mm-dd-test_post.md` to
+`_drafts/test_post.md`. (TODO: add flags for no-delete post, no-update
+timestamp, and custom slug for unpublished draft (?))
+
+
+### Script usage
+
+The actual work is done in `MrPoole::Commands`: calls into that class return
+the path name for newly created files, so you can do something useful with
+them if you want to. This should get better in the future.
+
+
+## To do
+
+- Configuration: custom templates, hooking into jekyll's `_config.yml`
+- Support for multiple output formats (right now, only markdown is supported)
+- Better option handling (allow custom templates, more flexible date
+  substitution)
+- Better documentation (this is an open source project, after all)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'mr_poole'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install mr_poole
+
+## Contact
+
+Contact me on Github, at michael@mcclimon.org, or on twitter, @mmcclimon.
+
+## Contributing
+
+1. Fork it
+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 new Pull Request

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec) do |t|
+  t.rspec_opts = "--color --format doc"
+end

data/bin/poole

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+
+require 'mr_poole'
+
+action = ARGV.shift
+
+cli = MrPoole::CLI.new(ARGV)
+cli.execute(action)

data/lib/mr_poole/cli.rb

@@ -0,0 +1,85 @@
+require 'optparse'
+require 'ostruct'
+
+module MrPoole
+  class CLI
+
+    def initialize(args)
+      @helper = Helper.new
+      @helper.ensure_jekyll_dir
+
+      @params = args
+      @commands = Commands.new
+    end
+
+    def execute(action)
+      case action
+      when 'post' then handle_post
+      when 'draft' then handle_draft
+      when 'publish' then handle_publish
+      when 'unpublish' then handle_unpublish
+      else @helper.gen_usage
+      end
+    end
+
+    def handle_post
+      options = do_creation_options
+      options.title ||= @params.first
+
+      @helper.post_usage unless options.title
+      @commands.post(options.title, options.slug)
+    end
+
+    def handle_draft
+      options = do_creation_options
+      options.title ||= @params.first
+
+      @helper.draft_usage unless options.title
+      @commands.draft(options.title, options.slug)
+    end
+
+    def handle_publish
+      options = OpenStruct.new
+      opt_parser = OptionParser.new do |opts|
+        # eventually there will be options...not yet
+      end
+      opt_parser.parse! @params
+
+      path = @params.first
+      @helper.publish_usage unless path
+      @commands.publish(path)
+    end
+
+    def handle_unpublish
+      options = OpenStruct.new
+      opt_parser = OptionParser.new do |opts|
+        # eventually there will be options...not yet
+      end
+      opt_parser.parse! @params
+
+      path = @params.first
+      @helper.unpublish_usage unless path
+      @commands.unpublish(path)
+    end
+
+    def do_creation_options
+      options = OpenStruct.new
+      options.slug = nil
+      options.title = nil
+
+      opt_parser = OptionParser.new do |opts|
+        opts.on('-s', '--slug [SLUG]', "Use custom slug") do |s|
+          options.slug = s
+        end
+
+        opts.on('-t', '--title [TITLE]', "Specifiy title") do |t|
+          options.title = t
+        end
+      end
+
+      opt_parser.parse! @params
+      options
+    end
+
+  end
+end

data/lib/mr_poole/commands.rb

@@ -0,0 +1,110 @@
+require 'fileutils'
+require 'shellwords'
+
+module MrPoole
+  class Commands
+
+    POSTS_FOLDER = '_posts'
+    DRAFTS_FOLDER = '_drafts'
+
+    def initialize
+      @helper = Helper.new
+      @default_layout = @helper.get_default_layout
+    end
+
+    # Generate a timestamped post
+    def post(title, slug='')
+      date = @helper.get_date_stamp
+
+      # still want to escape any garbage in the slug
+      slug = title if slug.nil? || slug.empty?
+      slug = @helper.get_slug_for(slug)
+
+      # put the metadata into the layout header
+      head = @default_layout
+      head.sub!(/^title:\s*$/, "title: #{title}")
+      head.sub!(/^date:\s*$/, "date: #{date}")
+
+      path = File.join(POSTS_FOLDER, "#{date}-#{slug}.md")
+      f = File.open(path, "w")
+      f.write(head)
+      f.close
+
+      path    # return the path, in case we want to do anything useful
+    end
+
+    # Generate a non-timestamped draft
+    def draft(title, slug='')
+      # the drafts folder might not exist yet...create it just in case
+      FileUtils.mkdir_p(DRAFTS_FOLDER)
+
+      slug = title if slug.nil? || slug.empty?
+      slug = @helper.get_slug_for(slug)
+
+      head = @default_layout
+      head.sub!(/^title:\s*$/, "title: #{title}")
+
+      path = File.join(DRAFTS_FOLDER, "#{slug}.md")
+      f = File.open(path, "w")
+      f.write(head)
+      f.close
+
+      path    # return the path, in case we want to do anything useful
+    end
+
+    # Todo make this take a path instead?
+    def publish(draftpath)
+      slug = File.basename(draftpath, '.md')
+
+      begin
+        infile = File.open(draftpath, "r")
+      rescue Errno::ENOENT
+        @helper.bad_path(draftpath)
+      end
+
+      date = @helper.get_date_stamp
+      time = @helper.get_time_stamp
+
+      outpath = File.join(POSTS_FOLDER, "#{date}-#{slug}.md")
+      outfile = File.open(outpath, "w")
+
+      infile.each_line do |line|
+        l = line.sub(/^date:\s*$/, "date: #{date} #{time}\n")
+        outfile.write(l)
+      end
+
+      infile.close
+      outfile.close
+      FileUtils.rm(draftpath)
+
+      outpath
+    end
+
+    def unpublish(inpath)
+      # the drafts folder might not exist yet...create it just in case
+      FileUtils.mkdir_p(DRAFTS_FOLDER)
+
+      begin
+        infile = File.open(inpath, "r")
+      rescue Errno::ENOENT
+        @helper.bad_path(inpath)
+      end
+
+      slug = inpath.sub(/.*?\d{4}-\d{2}-\d{2}-(.*)/, '\1')
+      outpath = File.join(DRAFTS_FOLDER, slug)
+      outfile = File.open(outpath, "w")
+
+      infile.each_line do |line|
+        l = line.sub(/^date:\s*.*$/, "date:")
+        outfile.write(l)
+      end
+
+      infile.close
+      outfile.close
+      FileUtils.rm(inpath)
+
+      outpath
+    end
+
+  end
+end

data/lib/mr_poole/helper.rb

@@ -0,0 +1,113 @@
+module MrPoole
+  class Helper
+
+    def initialize
+      # nothing to do here
+    end
+
+    # Check for a _posts directory in current directory
+    # If we don't find one, puke an error message and die
+    def ensure_jekyll_dir
+      unless Dir.exists?('./_posts')
+        puts 'ERROR: Cannot locate _posts directory. Double check to make sure'
+        puts '       that you are in a jekyll directory.'
+        exit
+      end
+    end
+
+    # Configure the default layout.
+    #
+    # If a user has $HOME/.poole_default_layout, will use the contents of
+    # that file, otherwise will use a simple template
+    def get_default_layout
+      config_path = File.join(Dir.home, '.poole_default_layout')
+
+      if File.exists?(config_path)
+        return File.open(config_path, 'r').read
+      else
+        s  = "---\n"
+        s << "title:\n"
+        s << "layout: post\n"
+        s << "date:\n"
+        s << "---\n"
+      end
+    end
+
+    # Given a post title (mixed case, spaces, etc.), generates a slug for
+    # This clobbers any non-ASCII text (TODO don't do that)
+    def get_slug_for(title)
+      title.downcase.gsub(/[^a-z0-9_\s-]/, '').gsub(/\s+/, '_')
+    end
+
+    def get_date_stamp
+      Time.now.strftime("%Y-%m-%d")
+    end
+
+    def get_time_stamp
+      Time.now.strftime("%H:%M")
+    end
+
+    def bad_path(path)
+      puts "Error: could not open #{path}"
+      exit
+    end
+
+    # Print a usage message and exit
+    def gen_usage
+      puts 'Usage:'
+      puts '  poole [ACTION] [ARG]'
+      puts ''
+      puts 'Actions:'
+      puts '  draft      Create a new draft in _drafts with title SLUG'
+      puts '  post       Create a new timestamped post in _posts with title SLUG'
+      puts '  publish    Publish the draft with SLUG, timestamping appropriately'
+      puts '  unpublish  Move a post to _drafts, untimestamping appropriately'
+      exit
+    end
+
+    def post_usage
+      puts 'Usage:'
+      puts '  poole post [OPTION] [ARG] TITLE'
+      puts ''
+      puts 'Options:'
+      puts '  --slug    Define a custom slug for post, used for generated file name'
+      puts '            (also available with -s)'
+      puts '  --title   Define a title for post (also available with -t)'
+      puts '            This option may be omitted provided that TITLE is given as'
+      puts '            the last argument to poole'
+      exit
+    end
+
+    def draft_usage
+      puts 'Usage:'
+      puts '  poole draft [OPTION] [ARG] TITLE'
+      puts ''
+      puts 'Options:'
+      puts '  --slug    Define a custom slug for post, used for generated file name'
+      puts '            (also available with -s)'
+      puts '  --title   Define a title for post (also available with -t)'
+      puts '            This option may be omitted provided that TITLE is given as'
+      puts '            the last argument to poole'
+      exit
+    end
+
+    def publish_usage
+      puts 'Usage:'
+      puts '  poole publish PATH_TO_DRAFT'
+      puts ''
+      puts 'Options:'
+      puts '  (coming soon)'
+      exit
+    end
+
+    def unpublish_usage
+      puts 'Usage:'
+      puts '  poole unpublish PATH_TO_POST'
+      puts ''
+      puts 'Options:'
+      puts '  (coming soon)'
+      exit
+    end
+
+  end
+end

data/lib/mr_poole/version.rb

@@ -0,0 +1,3 @@
+module MrPoole
+  VERSION = '0.1.0'
+end

data/lib/mr_poole.rb

@@ -0,0 +1,8 @@
+require 'fileutils'
+
+require 'mr_poole/commands'
+require 'mr_poole/helper'
+require 'mr_poole/cli'
+
+module MrPoole
+end

data/mr_poole.gemspec

@@ -0,0 +1,33 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'mr_poole/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "mr_poole"
+  spec.version       = MrPoole::VERSION
+  spec.authors       = ["Michael McClimon"]
+  spec.email         = ["michael@mcclimon.org"]
+  spec.description   = %q{A butler for Jekyll, provides interface for creating posts/drafts}
+  spec.summary       = <<-EOF
+    A butler for Jekyll. Provides a command-line interface (called `poole`) for
+    creating and publishing posts and drafts for Jekyll (http://jekyllrb.com)
+    blogs.
+
+    The literary Mr. Poole is Jekyll's butler, who "serves Jekyll faithfully, and
+    attempts to do a good job and be loyal to his master"
+    (http://en.wikipedia.org/wiki/Jekyll_and_hyde#Mr._Poole), and the
+    Mr. Poole gem looks to be the same thing.
+  EOF
+  spec.homepage      = "http://github.com/mmcclimon/mr_poole"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  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_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rspec"
+  spec.add_development_dependency "rake"
+end

data/spec/cli_spec.rb

@@ -0,0 +1,328 @@
+require 'spec_helper'
+
+require 'mr_poole'
+require 'fileutils'
+require 'stringio'
+
+module MrPoole
+  describe CLI do
+
+    context 'should determine jekyll dir correctly' do
+
+      it 'should exit with no _posts directory' do
+        olddir, tmpdir = make_no_jekyll_dir
+
+        argv = []
+        output = capture_stdout do
+          begin
+            cli = CLI.new(argv)
+          rescue SystemExit => e
+            e.should be_instance_of(SystemExit)
+          end
+        end
+
+        clean_tmp_files(tmpdir, olddir)
+      end
+
+      it 'should not exit with _posts directory' do
+        olddir, tmpdir = make_jekyll_dir
+
+        argv = []
+        lambda { cli = CLI.new(argv) }.should_not raise_error
+
+        clean_tmp_files(tmpdir, olddir)
+      end
+
+    end   # end context determine jekyll dir
+
+    describe "action 'post'" do
+
+      before :each do
+        @olddir, @tmpdir = make_jekyll_dir
+      end
+
+      after :each do
+        clean_tmp_files(@tmpdir, @olddir)
+      end
+
+      context 'error handling' do
+
+        it 'should fail with no arguments' do
+          argv = ['post']
+
+          expect {
+            poole_with_args_no_stdout(argv).call
+          }.to raise_error(SystemExit)
+        end
+
+        it 'should fail with no title (with slug)' do
+          argv = ['post', '-s', 'post_slug']
+
+          expect {
+            poole_with_args_no_stdout(argv).call
+          }.to raise_error(SystemExit)
+        end
+
+        it 'should not fail with a title (no switch)' do
+          argv = ['post', 'Here is a title']
+
+          expect {
+            poole_with_args_no_stdout(argv).call
+          }.not_to raise_error
+        end
+
+        it 'should not fail with a title (long switch)' do
+          argv = ['post', '--title', 'Here is a title']
+
+          expect {
+            poole_with_args_no_stdout(argv).call
+          }.not_to raise_error
+        end
+
+        it 'should not fail with a title (short switch)' do
+          argv = ['post', '-t', 'Here is a title']
+
+          expect {
+            poole_with_args_no_stdout(argv).call
+          }.not_to raise_error
+        end
+
+      end   # context error handling
+
+      context 'exit message' do
+
+        it 'should exit with a usage message' do
+          argv = ['post']
+
+          output = capture_stdout do
+            begin
+              poole_with_args(argv).call
+            rescue SystemExit => e
+              # this will fail, but we want the exit message
+            end
+          end
+
+          output.should match(/Usage:\s+poole post/)
+        end
+
+      end   # context exit message
+
+    end   # end describe post
+
+    describe "action 'draft'" do
+
+      before :each do
+        @olddir, @tmpdir = make_jekyll_dir
+      end
+
+      after :each do
+        clean_tmp_files(@tmpdir, @olddir)
+      end
+
+      context 'error handling' do
+
+        it 'should fail with no arguments' do
+          argv = ['draft']
+
+          expect {
+            poole_with_args_no_stdout(argv).call
+          }.to raise_error(SystemExit)
+        end
+
+        it 'should fail with no title (with slug)' do
+          argv = ['draft', '-s', 'draft_slug']
+
+          expect {
+            poole_with_args_no_stdout(argv).call
+          }.to raise_error(SystemExit)
+        end
+
+        it 'should not fail with a title (no switch)' do
+          argv = ['draft', 'Here is a title']
+
+          expect {
+            poole_with_args_no_stdout(argv).call
+          }.not_to raise_error
+        end
+
+        it 'should not fail with a title (long switch)' do
+          argv = ['draft', '--title', 'Here is a title']
+
+          expect {
+            poole_with_args_no_stdout(argv).call
+          }.not_to raise_error
+        end
+
+        it 'should not fail with a title (short switch)' do
+          argv = ['draft', '-t', 'Here is a title']
+
+          expect {
+            poole_with_args_no_stdout(argv).call
+          }.not_to raise_error
+        end
+
+      end   # context error handling
+
+      context 'exit message' do
+
+        it 'should exit with a usage message' do
+          argv = ['draft']
+
+          output = capture_stdout do
+            begin
+              poole_with_args(argv).call
+            rescue SystemExit
+              # this will fail, but we want the exit message
+            end
+          end
+
+          output.should match(/Usage:\s+poole draft/)
+        end
+
+      end   # context exit message
+
+    end   # end describe draft
+
+    describe "action 'publish'" do
+      before :each do
+        @olddir, @tmpdir = make_jekyll_dir
+        @c = Commands.new
+        @d_path = @c.draft('test_draft')
+      end
+
+      after :each do
+        clean_tmp_files(@tmpdir, @olddir)
+      end
+
+      context 'error handling' do
+
+        it 'should fail with no arguments' do
+          argv = ['publish']
+
+          expect {
+            poole_with_args_no_stdout(argv).call
+          }.to raise_error(SystemExit)
+        end
+
+        it 'should fail with a bad path' do
+          argv = ['publish', '_drafts/does_not_exist.md']
+
+          expect {
+            poole_with_args_no_stdout(argv).call
+          }.to raise_error(SystemExit)
+        end
+
+        it 'should not fail with a good path' do
+          argv = ['publish', @d_path]
+
+          expect {
+            poole_with_args_no_stdout(argv).call
+          }.not_to raise_error
+        end
+
+      end   # context error handling
+
+      context 'exit message' do
+
+        it 'should exit with usage with no arguments' do
+          argv = ['publish']
+
+          output = capture_stdout do
+            begin
+              poole_with_args(argv).call
+            rescue SystemExit
+            end
+          end
+
+          output.should match(/Usage:\s+poole publish/)
+        end
+
+        it 'should exit with a description of bad path' do
+          argv = ['publish', '_drafts/does_not_exist.md']
+
+          output = capture_stdout do
+            begin
+              poole_with_args(argv).call
+            rescue SystemExit
+            end
+          end
+
+          output.should match(/Error:\s+could not open/)
+        end
+      end   # context exit message
+
+    end
+
+    describe "action 'unpublish'" do
+      before :each do
+        @olddir, @tmpdir = make_jekyll_dir
+        @c = Commands.new
+        @p_path = @c.post('test_post')
+      end
+
+      after :each do
+        clean_tmp_files(@tmpdir, @olddir)
+      end
+
+      context 'error handling' do
+
+        it 'should fail with no arguments' do
+          argv = ['unpublish']
+
+          expect {
+            poole_with_args_no_stdout(argv).call
+          }.to raise_error(SystemExit)
+        end
+
+        it 'should fail with a bad path' do
+          argv = ['unpublish', '_posts/does_not_exist.md']
+
+          expect {
+            poole_with_args_no_stdout(argv).call
+          }.to raise_error(SystemExit)
+        end
+
+        it 'should not fail with a good path' do
+          argv = ['unpublish', @p_path]
+
+          expect {
+            poole_with_args_no_stdout(argv).call
+          }.not_to raise_error
+        end
+
+      end   # context error handling
+
+      context 'exit message' do
+
+        it 'should exit with usage with no arguments' do
+          argv = ['unpublish']
+
+          output = capture_stdout do
+            begin
+              poole_with_args(argv).call
+            rescue SystemExit
+            end
+          end
+
+          output.should match(/Usage:\s+poole unpublish/)
+        end
+
+        it 'should exit with a description of bad path' do
+          argv = ['unpublish', '_posts/does_not_exist.md']
+
+          output = capture_stdout do
+            begin
+              poole_with_args(argv).call
+            rescue SystemExit
+            end
+          end
+
+          output.should match(/Error:\s+could not open/)
+        end
+      end   # context exit message
+
+
+    end   # action unpublish
+
+  end
+end

data/spec/command_spec.rb

@@ -0,0 +1,290 @@
+require 'spec_helper'
+
+require 'mr_poole'
+
+module MrPoole
+  describe Commands do
+
+    before :all do
+      @date_regex = %r{\d{4}-\d{2}-\d{2}}
+    end
+
+    before :each do
+      @c = Commands.new
+      @olddir, @tmpdir = make_jekyll_dir
+    end
+
+    after :each do
+      clean_tmp_files(@tmpdir, @olddir)
+    end
+
+    describe "#post" do
+      context 'title only' do
+
+        it "should create a new post in the _posts directory" do
+          @c.post("test_post")
+          Dir.glob("_posts/*.md").length.should == 1
+        end
+
+        it "should create a timestamped post in the _posts directory" do
+          @c.post("test_post")
+          fn = Dir.glob("_posts/*.md").first
+          fn.should match(/#{@date_regex}-test_post[.]md$/)
+        end
+
+        it "should return path to the newly created post" do
+          returned = @c.post("test_post")
+          determined = Dir.glob("_posts/*.md").first
+          returned.should == determined
+        end
+
+        it "should downcase a title" do
+          @c.post("Test_Post_With_Uppercase")
+          fn = Dir.glob("_posts/*.md").first
+          fn.should match(/#{@date_regex}-test_post_with_uppercase[.]md/)
+        end
+
+        it "should sub underscores for spaces in title" do
+          @c.post("Test Post with Spaces")
+          fn = Dir.glob("_posts/*.md").first
+          fn.should match(/#{@date_regex}-test_post_with_spaces[.]md/)
+        end
+
+        it "should remove non-word characters for slug" do
+          @c.post("On (function() {}()) in JavaScript")
+          fn = Dir.glob("_posts/*.md").first
+          fn.should match(/#{@date_regex}-on_function_in_javascript[.]md/)
+        end
+
+        it "should update the title in the file itself" do
+          @c.post("Testing Post {}")
+          fn = Dir.glob("_posts/*.md").first
+          content = File.open(fn, 'r').read
+          content.should match(/title: Testing Post {}/)
+        end
+
+        it "should update the date in the file itself" do
+          @c.post("Date test post")
+          fn = Dir.glob("_posts/*.md").first
+
+          # date in filename should match date in file itself
+          date = fn.match(/(#{@date_regex})-date_test_post[.]md/)[1]
+          content = File.open(fn, 'r').read
+          content.should match(/date: #{date}/)
+        end
+
+      end   # end context title only
+
+      context 'title and slug' do
+
+        it "should create a post named for slug" do
+          @c.post("Test Post", 'unique_slug')
+          fn = Dir.glob("_posts/*.md").first
+          fn.should match(/#{@date_regex}-unique_slug[.]md$/)
+        end
+
+        it "should sub any weird characters in slug" do
+          @c.post("Test Post with Spaces", "(stupid] {slüg/")
+          fn = Dir.glob("_posts/*.md").first
+          fn.should match(/#{@date_regex}-stupid_slg[.]md/)
+        end
+
+        it "should update the title in the file itself" do
+          @c.post("Testing Post {}", 'shouldnt_be_in_title')
+          fn = Dir.glob("_posts/*.md").first
+          content = File.open(fn, 'r').read
+          content.should match(/title: Testing Post {}/)
+        end
+
+      end   # end context title & slug
+
+    end   # end describe post
+
+    describe "#draft" do
+      context 'title only' do
+
+        it "should create a _drafts directory" do
+          @c.draft('draft post')
+          Dir.exists?('_drafts').should be_true
+        end
+
+        it "should create a new draft in the _drafts directory" do
+          @c.draft('draft post')
+          Dir.glob("_drafts/*.md").length.should == 1
+        end
+
+        it "should return path to the newly created draft" do
+          returned = @c.draft("test_draft")
+          determined = Dir.glob("_drafts/*.md").first
+          returned.should == determined
+        end
+
+        it "should create a non-timestamped draft" do
+          @c.draft('draft post')
+          fn = Dir.glob("_drafts/*.md").first
+          fn.should_not match(/#{@date_regex}/)
+        end
+
+        it "should downcase and underscore title for slug" do
+          @c.draft("Test Post with Spaces")
+          fn = Dir.glob("_drafts/*.md").first
+          fn.should match(/test_post_with_spaces[.]md/)
+        end
+
+        it "should remove non-word characters for slug" do
+          @c.draft("On (function() {}()) in JavaScript")
+          fn = Dir.glob("_drafts/*.md").first
+          fn.should match(/on_function_in_javascript[.]md/)
+        end
+
+        it "should update the title in the file itself" do
+          @c.draft("Testing Draft {}")
+          fn = Dir.glob("_drafts/*.md").first
+          content = File.open(fn, 'r').read
+          content.should match(/title: Testing Draft {}/)
+        end
+
+        it "should not update the date in the file itself" do
+          @c.draft("Date test post")
+          fn = Dir.glob("_drafts/*.md").first
+
+          # date in filename should match date in file itself
+          content = File.open(fn, 'r').read
+          content.should match(/date:\s*\n/)
+        end
+
+      end   # end context title only
+
+      context 'title and slug' do
+
+        it "should create a draft named for slug" do
+          @c.draft("Test Draft", 'unique_slug')
+          fn = Dir.glob("_drafts/*.md").first
+          fn.should match(/unique_slug[.]md$/)
+        end
+
+        it "should sub any weird characters in slug" do
+          @c.draft("Test Post with Spaces", "(stupid] {slüg/")
+          fn = Dir.glob("_drafts/*.md").first
+          fn.should match(/stupid_slg[.]md/)
+        end
+
+        it "should update the title in the file itself" do
+          @c.draft("Testing Post {}", 'shouldnt_be_in_title')
+          fn = Dir.glob("_drafts/*.md").first
+          content = File.open(fn, 'r').read
+          content.should match(/title: Testing Post {}/)
+        end
+
+      end   # end context title & slug
+
+    end   # end describe draft
+
+    describe "#publish" do
+
+      before :each do
+        @d_path = @c.draft('test_draft')
+      end
+
+      it 'should create a timestamped post in the _posts folder' do
+        @c.publish(@d_path)
+        fn = Dir.glob("_posts/*.md").first
+        fn.should match(/#{@date_regex}-test_draft[.]md$/)
+      end
+
+      it 'should remove file in the _drafts folder' do
+        @c.publish(@d_path)
+        File.exist?(@d_path).should be_false
+      end
+
+      it 'should return path to newly created post' do
+        returned = @c.publish(@d_path)
+        determined = Dir.glob("_posts/*.md").first
+        returned.should == determined
+      end
+
+      it 'should create post with matching slug' do
+        post = @c.publish(@d_path)
+
+        draft_slug = File.basename(@d_path, '.md')
+        post_slug = post.match(/#{@date_regex}-(.*)[.]md/)[1]
+
+        post_slug.should == draft_slug
+      end
+
+      it 'should update timestamp in actual file' do
+        post = @c.publish(@d_path)
+        content = File.open(post, 'r').read
+        content.should match(/date: #{@date_regex} \d{2}:\d{2}\n/)
+      end
+
+      it 'should copy contents of draft into post' do
+        # first add some content to the draft
+        f = File.open(@d_path, 'a')
+        f.write("Some new content for my blog\n")
+        f.close
+
+        post = @c.publish(@d_path)
+        content = File.open(post, 'r').read
+        content.should match(/Some new content for my blog/)
+      end
+
+    end   # end describe publish
+
+    describe "#unpublish" do
+
+      before :each do
+        @p_path = @c.post('test_post')
+      end
+
+      it 'should create a _drafts directory' do
+        @c.unpublish(@p_path)
+        Dir.exists?('_drafts').should be_true
+      end
+
+      it 'should create an untimestamped draft in the _drafts folder' do
+        @c.unpublish(@p_path)
+        fn = Dir.glob("_drafts/*.md").first
+        fn.should_not match(/#{@date_regex}/)
+      end
+
+      it 'should remove file in the _posts folder' do
+        @c.unpublish(@p_path)
+        File.exist?(@p_path).should be_false
+      end
+
+      it 'should return path to newly created draft' do
+        returned = @c.unpublish(@p_path)
+        determined = Dir.glob("_drafts/*.md").first
+        returned.should == determined
+      end
+
+      it 'should create draft with matching slug' do
+        draft = @c.unpublish(@p_path)
+
+        post_slug = @p_path.match(/#{@date_regex}-(.*)[.]md$/)[1]
+        draft_slug = File.basename(draft, '.md')
+
+        draft_slug.should == post_slug
+      end
+
+      it 'should delete timestamp in actual file' do
+        draft = @c.unpublish(@p_path)
+        content = File.open(draft, 'r').read
+        content.should match(/date:\s*\n/)
+      end
+
+      it 'should copy contents of post into draft' do
+        # first add some content to the draft
+        f = File.open(@p_path, 'a')
+        f.write("Some new content for my blog\n")
+        f.close
+
+        draft = @c.unpublish(@p_path)
+        content = File.open(draft, 'r').read
+        content.should match(/Some new content for my blog/)
+      end
+
+    end   # end describe unpublish
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,57 @@
+#!/usr/bin/env ruby
+
+require 'stringio'
+require 'tmpdir'
+require 'fileutils'
+
+def capture_stdout(&block)
+  stdout = $stdout
+  fake_out = StringIO.new
+  $stdout = fake_out
+  begin
+    yield
+  ensure
+    $stdout = stdout
+  end
+  fake_out.string
+end
+
+def make_no_jekyll_dir
+  olddir = Dir.pwd()
+  newdir = Dir.mktmpdir('nojekyll')
+  Dir.chdir(newdir)
+  return olddir, newdir
+end
+
+def make_jekyll_dir
+  olddir = Dir.pwd()
+  newdir = Dir.mktmpdir('jekyll')
+  posts = File.join(newdir, '_posts')
+  Dir.mkdir(posts)
+  Dir.chdir(newdir)
+  return olddir, newdir
+
+end
+
+def clean_tmp_files(tmpdir, restoredir)
+  Dir.chdir(restoredir)
+  FileUtils.rm_rf(tmpdir)
+end
+
+def poole_with_args(argv)
+  return Proc.new do
+    action = argv.shift
+    cli = MrPoole::CLI.new(argv)
+    cli.execute(action)
+  end
+end
+
+def poole_with_args_no_stdout(argv)
+  return Proc.new do
+    capture_stdout do
+      action = argv.shift
+      cli = MrPoole::CLI.new(argv)
+      cli.execute(action)
+    end
+  end
+end

metadata

@@ -0,0 +1,109 @@
+--- !ruby/object:Gem::Specification
+name: mr_poole
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Michael McClimon
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-09-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  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'
+- !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: A butler for Jekyll, provides interface for creating posts/drafts
+email:
+- michael@mcclimon.org
+executables:
+- poole
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- bin/poole
+- lib/mr_poole.rb
+- lib/mr_poole/cli.rb
+- lib/mr_poole/commands.rb
+- lib/mr_poole/helper.rb
+- lib/mr_poole/version.rb
+- mr_poole.gemspec
+- spec/cli_spec.rb
+- spec/command_spec.rb
+- spec/spec_helper.rb
+homepage: http://github.com/mmcclimon/mr_poole
+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.1.4
+signing_key: 
+specification_version: 4
+summary: A butler for Jekyll. Provides a command-line interface (called `poole`) for
+  creating and publishing posts and drafts for Jekyll (http://jekyllrb.com) blogs.  The
+  literary Mr. Poole is Jekyll's butler, who "serves Jekyll faithfully, and attempts
+  to do a good job and be loyal to his master" (http://en.wikipedia.org/wiki/Jekyll_and_hyde#Mr._Poole),
+  and the Mr. Poole gem looks to be the same thing.
+test_files:
+- spec/cli_spec.rb
+- spec/command_spec.rb
+- spec/spec_helper.rb