bookingit 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 175d9e2e4bc7ae8b5e306939a82fa7abaea84501
+  data.tar.gz: 7c0b21bcb5891004f1f511acd377897090e24c9b
+SHA512:
+  metadata.gz: d1fb9e1d38399731774ec84c4361211fa36ae177d0f02a90662948b2ddf2590a2ff36fcc259b037a03e88dedc37292df03ab3e89417f4fab0f1b490b08eac782
+  data.tar.gz: ab1ae505a8b1fe697929e92d7f6968761eae1478546bd7410fda1027a8817b26188d9a31e067c0c9489c55542b9d656074a3b1bd64d8eebed88d1daee9f8de19

data/.gitignore

@@ -0,0 +1,51 @@
+
+# See http://help.github.com/ignore-files/ for more about ignoring files.
+#
+# If you find yourself ignoring temporary files generated by your text editor
+# or operating system, you probably want to add a global ignore instead:
+#   git config --global core.excludesfile ~/.gitignore_global
+
+# Ignore bundler config
+/.bundle
+
+# Ignore the default SQLite database.
+/db/*.sqlite3
+
+# Ignore all logfiles and tempfiles.
+/log/*.log
+/tmp
+# vim
+*.sw?
+*.rbc
+*.sassc
+.sass-cache
+capybara-*.html
+.rspec
+/vendor/bundle
+/public/system/*
+/coverage/
+/spec/tmp/*
+**.orig
+rerun.txt
+pickle-email-*.html
+
+.rvmrc
+.rbenv-version
+
+config/database.yml
+
+.idea/*
+
+.DS_Store
+# Emacs
+.\#*
+*~
+\#*
+
+.vimrc
+.jhw-cache
+.tddium*
+db/tmp
+spec/file-upload/stylecard-from-db.jpg
+.env
+results.html

data/.ruby-gemset

@@ -0,0 +1 @@
+bookingit

data/.ruby-version

@@ -0,0 +1 @@
+2.1.0

data/Gemfile

@@ -0,0 +1,2 @@
+source 'https://rubygems.org'
+gemspec

data/Gemfile.lock

@@ -0,0 +1,52 @@
+PATH
+  remote: .
+  specs:
+    bookingit (0.0.1)
+      gli
+      redcarpet
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    aruba (0.5.4)
+      childprocess (>= 0.3.6)
+      cucumber (>= 1.1.1)
+      rspec-expectations (>= 2.7.0)
+    builder (3.2.2)
+    childprocess (0.5.1)
+      ffi (~> 1.0, >= 1.0.11)
+    clean_test (1.0.0)
+      faker
+    cucumber (1.3.11)
+      builder (>= 2.1.2)
+      diff-lcs (>= 1.1.3)
+      gherkin (~> 2.12)
+      multi_json (>= 1.7.5, < 2.0)
+      multi_test (>= 0.0.2)
+    diff-lcs (1.2.5)
+    faker (1.2.0)
+      i18n (~> 0.5)
+    ffi (1.9.3)
+    gherkin (2.12.2)
+      multi_json (~> 1.3)
+    gli (2.9.0)
+    i18n (0.6.9)
+    json (1.8.1)
+    multi_json (1.8.4)
+    multi_test (0.0.3)
+    rake (10.1.1)
+    rdoc (4.1.1)
+      json (~> 1.4)
+    redcarpet (3.1.1)
+    rspec-expectations (2.14.5)
+      diff-lcs (>= 1.1.3, < 2.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  aruba
+  bookingit!
+  clean_test
+  rake
+  rdoc

data/README.rdoc

@@ -0,0 +1,103 @@
+= bookingit
+
+A basic publishing system that takes Mardown and a Git repository and produces a readable "book" in the following forms:
+
+* Website
+* PDF
+* EBook
+
+The idea is to easily show the evolution of code over the course of the book, based entirely on git diffs and pull requests.
+
+== Example
+
+
+    Here is how our controller looks currently:
+
+        git:///path/to/repo.git/app/controlleres/users_controller.rb#initial-version
+
+    We'd like to change the mailer call to use Resque
+
+        git:///path/to/repo.git/app/controllers/users_controller.rb#initial-version..add-resque-to-controller
+
+
+This bit of Markdown would be interpretted as if the contents were placed inline like so:
+
+    Here is how our controller looks currently:
+
+    ```ruby
+    class UsersController < ApplicationController::Base
+      def create
+        @user = User.new(params.require(:user))
+        if @user.save
+          UserMailer.welcome_email(user).deliver
+          redirect_to root_path
+        else
+          render 'new'
+        end
+      end
+    end
+    ```
+
+    We'd like to change the mailer call to use Resque
+
+    ```diff
+    --- a/app/controllers/users_controller.rb
+    +++ b/app/controllers/users_controller.rb
+      def create
+        @user = User.new(params.require(:user))
+        if @user.save
+    -     UserMailer.welcome_email(user).deliver
+    +     Resque.enqueue(WelcomeEmailJob,user.id)
+          redirect_to root_path
+        else
+    ```
+
+We can also insert the output of commands:
+
+    Now, let's run our tests
+
+    sh:///path/to/wherever#rake test
+
+This would be as if the output were inline like so:
+
+
+    Now, let's run our tests.
+
+    ```bash
+    > rake test
+    ...........................
+
+    Finished in 0.00946 seconds
+    27 examples, 0 failures
+
+    Randomized with seed 43200
+    ```
+
+== TODO
+
+Given the above, a minimal solution would be:
+
+* Given some markdown files
+* And a configuration file
+* Be able to generate a multi-page HTML5 website with a table of contents
+
+=== Configuration
+
+At the bare minimum the configuration file needs to indicate a structure that maps sections to markdown files.  Something like this:
+
+    {
+      front_matter: [
+        "acknowledgements.md",
+        "intro.md"
+      ],
+      main_matter: [
+        "getting_started.md",
+        ["our_first_controller.md","our_first_model.md","running_tests.md"],
+        "chapter3*.md",
+      ],
+      back_matter: [
+        "glossary.md"
+      ]
+    }
+
+We have front, main, and back matter.  Inside each we can provide a list of files the be used in order, that represent "chapters" in that section.  A chapter can be specified either as a single file, a list of files that are subsections, or a glob.  No markup is added, this just specifies the order of processing and how to make the TOC.

data/Rakefile

@@ -0,0 +1,48 @@
+require 'rake/clean'
+require 'rubygems'
+require 'rubygems/package_task'
+require 'rdoc/task'
+require 'cucumber'
+require 'cucumber/rake/task'
+require 'bundler'
+
+Bundler::GemHelper.install_tasks
+
+Rake::RDocTask.new do |rd|
+  rd.main = "README.rdoc"
+  rd.rdoc_files.include("README.rdoc","lib/**/*.rb","bin/**/*")
+  rd.title = 'Your application title'
+end
+
+spec = eval(File.read('bookingit.gemspec'))
+
+Gem::PackageTask.new(spec) do |pkg|
+end
+CUKE_RESULTS = 'results.html'
+CLEAN << CUKE_RESULTS
+desc 'Run features'
+Cucumber::Rake::Task.new(:features) do |t|
+  opts = "features --format html -o #{CUKE_RESULTS} --format progress -x"
+  opts += " --tags #{ENV['TAGS']}" if ENV['TAGS']
+  t.cucumber_opts =  opts
+  t.fork = false
+end
+
+desc 'Run features tagged as work-in-progress (@wip)'
+Cucumber::Rake::Task.new('features:wip') do |t|
+  tag_opts = ' --tags ~@pending'
+  tag_opts = ' --tags @wip'
+  t.cucumber_opts = "features --format html -o #{CUKE_RESULTS} --format pretty -x -s#{tag_opts}"
+  t.fork = false
+end
+
+task :cucumber => :features
+task 'cucumber:wip' => 'features:wip'
+task :wip => 'features:wip'
+require 'rake/testtask'
+Rake::TestTask.new do |t|
+  t.libs << "test"
+  t.test_files = FileList['test/*_test.rb']
+end
+
+task :default => [:test,:features]

data/bin/bookingit

@@ -0,0 +1,113 @@
+#!/usr/bin/env ruby
+require 'gli'
+require 'bookingit'
+
+include GLI::App
+include FileUtils
+
+program_desc 'Manage a bookingit book'
+
+version Bookingit::VERSION
+
+desc 'Set up a new book'
+arg_name 'dir (defaults to .)'
+command :init do |c|
+  c.action do |global_options,options,args|
+    dir = args.shift || "."
+    chdir dir do
+      File.open('config.json','w') do |file|
+        file.puts %{
+{
+  "front_matter": "front.md",
+  "main_matter": "main.md",
+  "back_matter": "back.md",
+}
+}
+      end
+      File.open("front.md",'w') do |file|
+        file.puts "# Intro Goes Here"
+      end
+      File.open("main.md",'w') do |file|
+        file.puts "# Main stuff here"
+      end
+      File.open("back.md",'w') do |file|
+        file.puts "# Appendeces and whatnot"
+      end
+    end
+  end
+end
+
+desc 'build your book from markdown files'
+arg_name 'config_file output_dir'
+command :build do |c|
+  c.action do |global_options,options,args|
+    puts pwd
+    config = Bookingit::Config.new(File.read(args.shift),File.expand_path('.'))
+    output_dir = args.shift
+    mkdir output_dir unless Dir.exists?(output_dir)
+
+    renderer = Bookingit::Renderer.new
+    redcarpet = Redcarpet::Markdown.new(renderer, no_intra_emphasis: true,
+                                                             tables: true,
+                                                 fenced_code_blocks: true,
+                                                           autolink: true,
+                                                      strikethrough: true,
+                                                        superscript: true)
+
+    chdir output_dir do
+      File.open('index.html','w') do |index|
+        index.puts %{<!DOCTYPE html>
+<html>
+<head>
+</head>
+<body>
+}
+        index.puts "<ol>"
+        %w(front_matter main_matter back_matter).each do |matter|
+          index.puts "<li>#{matter}<ol>"
+          config.send(matter).chapters.each_with_index do |chapter,i|
+            contents = if chapter.path.nil?
+                      chapter.sections.map(&:path).map { |path|
+                        File.read(path)
+                      }.join("\n")
+                    else
+                      File.read(chapter.path)
+                    end
+
+            output_file = "#{matter}_#{i+1}.html"
+            File.open(output_file,'w') do |file|
+              file.puts redcarpet.render(contents)
+            end
+            title = (Array(renderer.headers[1]) +
+                     Array(renderer.headers[2]) +
+                     Array(renderer.headers[3]) +
+                     Array(renderer.headers[4]) +
+                     Array(renderer.headers[5]) +
+                     Array(renderer.headers[6])).first
+            index.puts "<li><a href='#{output_file}'>#{title}</a></li>"
+          end
+          index.puts "</ol></li>"
+        end
+        index.puts "</ol>"
+        index.puts %{
+
+</body>
+</html>
+}
+      end
+    end
+  end
+end
+
+pre do |global,command,options,args|
+  true
+end
+
+post do |global,command,options,args|
+end
+
+on_error do |exception|
+  true
+end
+
+exit run(ARGV)

data/bookingit.gemspec

@@ -0,0 +1,25 @@
+# Ensure we require the local version and not one we might have installed already
+require File.join([File.dirname(__FILE__),'lib','bookingit','version.rb'])
+spec = Gem::Specification.new do |s| 
+  s.name = 'bookingit'
+  s.version = Bookingit::VERSION
+  s.author = 'Dave Copeland'
+  s.email = 'davetron5000@gmail.com'
+  s.homepage = 'http://www.naildrivin5.com'
+  s.platform = Gem::Platform::RUBY
+  s.summary = 'Write a code-heavy book in Markdown'
+# Add your other files here if you make them
+  s.require_paths << 'lib'
+  s.has_rdoc = true
+  s.extra_rdoc_files = ['README.rdoc']
+  s.rdoc_options << '--title' << 'bookingit' << '--main' << 'README.rdoc' << '-ri'
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.add_development_dependency('rake')
+  s.add_development_dependency('rdoc')
+  s.add_development_dependency('aruba')
+  s.add_development_dependency('clean_test')
+  s.add_runtime_dependency('gli')
+  s.add_runtime_dependency('redcarpet')
+end

data/features/bookingit.feature

@@ -0,0 +1,81 @@
+Feature: App does what it's supposed to do
+  In order to build a kickass website
+  I want to use bookingit to translate markdown
+  and all that
+
+  Scenario: App works
+    Given the file "intro.md" contains:
+    """
+# My awesome book
+
+This is the introduction
+    """
+    And the file "chapter1.md" contains:
+    """
+# It Begins
+
+This is the beginning
+
+```
+sh:///# ls
+```
+    """
+    And the file "chapter2.1.md" contains:
+    """
+# The continuation
+
+This is how we work
+
+## Some section
+
+Some more stuff
+    """
+    And the file "chapter2.2.md" contains:
+    """
+## Some other section
+
+Even more stuff
+    """
+    And the file "appendix.md" contains:
+    """
+# Glossary
+
+This is the glossary
+    """
+    And this config file:
+    """
+{
+  "front_matter": [
+    "intro.md"
+  ],
+  "main_matter": [
+    "chapter1.md",
+    "chapter2.*.md"
+  ],
+  "back_matter": [
+    "appendix.md"
+  ]
+}
+    """
+    When I run `bookingit build config.json book`
+    Then the exit status should be 0
+    And the file "book/front_matter_1.html" should contain "This is the introduction"
+    And the file "book/main_matter_1.html" should contain "This is the beginning"
+    And the file "book/main_matter_1.html" should contain "ls"
+    And the file "book/main_matter_2.html" should contain "This is how we work"
+    And the file "book/main_matter_2.html" should contain "Even more stuff"
+    And the file "book/back_matter_1.html" should contain "This is the glossary"
+    And the file "book/index.html" should contain "front_matter_1.html"
+    And the file "book/index.html" should contain "My awesome book"
+    And the file "book/index.html" should contain "main_matter_1.html"
+    And the file "book/index.html" should contain "It Begins"
+    And the file "book/index.html" should contain "main_matter_2.html"
+    And the file "book/index.html" should contain "The continuation"
+    And the file "book/index.html" should contain "back_matter_1.html"
+    And the file "book/index.html" should contain "Glossary"
+
+    @wip
+  Scenario: Init a new book
+    When I run `bookingit init`
+    Then a file named "config.json" should exist
+

data/features/step_definitions/bookinggit_steps.rb

@@ -0,0 +1,26 @@
+require 'tempfile'
+require 'fileutils'
+
+When /^I get help for "([^"]*)"$/ do |app_name|
+  @app_name = app_name
+  step %(I run `#{app_name} help`)
+end
+
+Given(/^the file "(.*?)" contains:$/) do |filename, contents|
+  FileUtils.chdir "tmp/aruba" do
+    @files_created << filename
+    File.open(filename,'w') do |file|
+      file.puts contents
+    end
+  end
+end
+
+Given(/^this config file:$/) do |string|
+  FileUtils.chdir "tmp/aruba" do
+    @files_created << "config.json"
+    File.open("config.json",'w') do |file|
+      file.puts string
+    end
+  end
+end
+

data/features/support/env.rb

@@ -0,0 +1,19 @@
+require 'aruba/cucumber'
+
+ENV['PATH'] = "#{File.expand_path(File.dirname(__FILE__) + '/../../bin')}#{File::PATH_SEPARATOR}#{ENV['PATH']}"
+LIB_DIR = File.join(File.expand_path(File.dirname(__FILE__)),'..','..','lib')
+
+Before do
+  # Using "announce" causes massive warnings on 1.9.2
+  @puts = true
+  @original_rubylib = ENV['RUBYLIB']
+  @files_created = []
+  ENV['RUBYLIB'] = LIB_DIR + File::PATH_SEPARATOR + ENV['RUBYLIB'].to_s
+end
+
+After do
+  ENV['RUBYLIB'] = @original_rubylib
+  @files_created.each do |file|
+    FileUtils.rm file
+  end
+end

data/lib/bookingit.rb

@@ -0,0 +1,3 @@
+require 'bookingit/version.rb'
+require 'bookingit/renderer.rb'
+require 'bookingit/config.rb'

data/lib/bookingit/config.rb

@@ -0,0 +1,56 @@
+require 'fileutils'
+require 'json'
+
+module Bookingit
+  class Config
+    include FileUtils
+
+    attr_reader :front_matter,
+                :main_matter,
+                :back_matter
+
+    def initialize(config_json,root_dir)
+      config_hash = JSON.parse(config_json)
+
+      @front_matter = Matter.new(config_hash['front_matter'],root_dir)
+      @main_matter  = Matter.new(config_hash['main_matter'],root_dir)
+      @back_matter  = Matter.new(config_hash['back_matter'],root_dir)
+    end
+
+    class Matter
+      attr_reader :chapters
+      def initialize(chapters_config,root_dir)
+        @chapters = Array(chapters_config).map { |chapter_config|
+          Chapter.new(chapter_config,root_dir)
+        }
+      end
+    end
+
+    class Chapter
+      attr_reader :sections
+      attr_reader :path
+
+      def initialize(chapter_config,root_dir)
+        files = Array(chapter_config).flatten(1).map { |file|
+          Dir[File.join(root_dir,file)]
+        }.flatten
+        if files.size == 1
+          @sections = []
+          @path = files[0]
+        else
+          @sections = files.map { |file|
+            Section.new(file)
+          }
+        end
+      end
+    end
+
+    class Section
+      attr_reader :path
+      def initialize(path)
+        @path = path
+      end
+    end
+  end
+
+end

data/lib/bookingit/renderer.rb

@@ -0,0 +1,68 @@
+require 'redcarpet'
+require 'cgi'
+require 'fileutils'
+
+module Bookingit
+  class Renderer < Redcarpet::Render::HTML
+    include FileUtils
+
+    attr_accessor :headers
+    def header(text,header_level,anchor)
+      @headers[header_level] ||= []
+      @headers[header_level] << text
+      "<h#{header_level}>#{text}</h#{header_level}>"
+    end
+
+    def doc_header
+      @headers = {}
+      ""
+    end
+
+    EXTENSION_TO_LANGUAGE = {
+      '.rb' => 'ruby',
+      '.html' => 'html',
+      '.scala' => 'scala',
+    }
+    def block_code(code, language)
+      if code.strip =~ /file:\/\/(.*)$/
+        path = $1
+        code = File.read(path)
+        language = EXTENSION_TO_LANGUAGE.fetch(File.extname(path))
+      elsif code.strip =~ /git:\/\/(.*)$/
+        path = $1
+        if path =~ /(^.*).git\/(.*)#([^#]+)$/
+          repo_path = $1
+          path_in_repo = $2
+          reference = $3
+          chdir repo_path do
+            if reference =~ /^(.+)\.\.(.+)$/
+              code = `git diff #{reference}`
+              language = 'diff'
+            else
+              `git checkout #{reference} 2>&1`
+              code = File.read(path_in_repo)
+              `git checkout master 2>&1`
+              language = EXTENSION_TO_LANGUAGE.fetch(File.extname(path_in_repo))
+            end
+          end
+        else
+          raise "You must provide a SHA1 or tagname: #{path}"
+        end
+      elsif code.strip =~ /sh:\/\/(.+)#([^#]+)$/
+        path = $1
+        command = $2
+        chdir path do
+          output = `#{command}`
+          code = "> #{command}\n#{output}"
+          language = 'shell'
+        end
+      end
+      css_class = if language.nil? || language.strip == ''
+                    ""
+                  else
+                    " class=\"language-#{language}\""
+                  end
+      %{<pre><code#{css_class}>#{CGI.escapeHTML(code)}</code></pre>}
+    end
+  end
+end

data/lib/bookingit/version.rb

@@ -0,0 +1,3 @@
+module Bookingit
+  VERSION = '0.0.1'
+end

data/test/config_test.rb

@@ -0,0 +1,119 @@
+require 'test_helper'
+require 'tempfile'
+require 'fileutils'
+require 'json'
+
+class Bookingit::ConfigTest < Test::Unit::TestCase
+
+  def setup
+    @tempdir = Dir.mktmpdir
+  end
+
+  def teardown
+    remove_entry @tempdir
+  end
+
+  test_that "wraps single files in arrays" do
+    Given :some_markdown_files
+    And {
+      @config = {
+        front_matter: "foo.md",
+        main_matter: "bar.md",
+        back_matter: "baz.md",
+      }
+    }
+    When {
+      @normalized_config = Bookingit::Config.new(@config.to_json,@tempdir)
+    }
+    Then {
+      assert_equal 1,@normalized_config.front_matter.chapters.size
+      assert_equal File.join(@tempdir,'foo.md'),@normalized_config.front_matter.chapters[0].path
+      assert_equal 1,@normalized_config.main_matter.chapters.size
+      assert_equal File.join(@tempdir,'bar.md'),@normalized_config.main_matter.chapters[0].path
+      assert_equal 0,@normalized_config.main_matter.chapters[0].sections.size
+      assert_equal 1,@normalized_config.back_matter.chapters.size
+      assert_equal File.join(@tempdir,'baz.md'),@normalized_config.back_matter.chapters[0].path
+    }
+  end
+
+  test_that "does nothing to arrays" do
+    Given :some_markdown_files
+    And {
+      @config = {
+        front_matter: ["foo.md"],
+        main_matter: ["bar.md"],
+        back_matter: ["baz.md"],
+      }
+    }
+    When {
+      @normalized_config = Bookingit::Config.new(@config.to_json,@tempdir)
+    }
+    Then {
+      assert_equal 1,@normalized_config.front_matter.chapters.size
+      assert_equal File.join(@tempdir,'foo.md'),@normalized_config.front_matter.chapters[0].path
+      assert_equal 1,@normalized_config.main_matter.chapters.size
+      assert_equal File.join(@tempdir,'bar.md'),@normalized_config.main_matter.chapters[0].path
+      assert_equal 0,@normalized_config.main_matter.chapters[0].sections.size
+      assert_equal 1,@normalized_config.back_matter.chapters.size
+      assert_equal File.join(@tempdir,'baz.md'),@normalized_config.back_matter.chapters[0].path
+    }
+  end
+
+  test_that "parses sections" do
+    Given :some_markdown_files
+    And {
+      @config = {
+        front_matter: ["foo.md"],
+        main_matter: [
+          "bar.md",
+          ["blah1.md","blah2.md"],
+        ],
+        back_matter: ["baz.md"],
+      }
+    }
+    When {
+      @normalized_config = Bookingit::Config.new(@config.to_json,@tempdir)
+    }
+    Then {
+      assert_equal 2,@normalized_config.main_matter.chapters.size,"chapters"
+      assert_equal 2,@normalized_config.main_matter.chapters[1].sections.size,"sections"
+    }
+  end
+
+  test_that "globs" do
+    Given :some_markdown_files
+    And {
+      @config = {
+        front_matter: ["foo.md"],
+        main_matter: [
+          "bar.md",
+          "blah*.md",
+        ],
+        back_matter: ["baz.md"],
+      }
+    }
+    When {
+      @normalized_config = Bookingit::Config.new(@config.to_json,@tempdir)
+    }
+    Then {
+      assert_equal 2,@normalized_config.main_matter.chapters.size
+      assert_equal 3,@normalized_config.main_matter.chapters[1].sections.size
+      assert_equal File.join(@tempdir,'blah1.md'),@normalized_config.main_matter.chapters[1].sections[0].path
+      assert_equal File.join(@tempdir,'blah2.md'),@normalized_config.main_matter.chapters[1].sections[1].path
+      assert_equal File.join(@tempdir,'blah3.md'),@normalized_config.main_matter.chapters[1].sections[2].path
+    }
+  end
+
+private
+
+  def some_markdown_files
+    chdir @tempdir do
+      system "touch foo.md"
+      system "touch baz.md"
+      system "touch bar.md"
+      system "touch blah1.md"
+      system "touch blah2.md"
+      system "touch blah3.md"
+    end
+  end
+end

data/test/renderer_test.rb

@@ -0,0 +1,269 @@
+require 'test_helper'
+require 'tempfile'
+require 'fileutils'
+
+include FileUtils
+
+class RendererTest < Test::Unit::TestCase
+
+  def setup
+    @tempdir = Dir.mktmpdir
+  end
+
+  def teardown
+    remove_entry @tempdir
+  end
+
+  test_that "block_code can read a file URL and guess ruby" do
+    Given a_file_with_extension(".rb") 
+    When render_file_url_code_block
+    Then {
+      assert_equal %{<pre><code class="language-ruby">#{@code}</code></pre>},@html
+    }
+  end
+
+  test_that "block_code can read a file URL and guess scala" do
+    Given a_file_with_extension(".scala") 
+    When render_file_url_code_block
+    Then {
+      assert_equal %{<pre><code class="language-scala">#{@code}</code></pre>},@html
+    }
+  end
+
+  test_that "it HTML-escapes" do
+    Given a_file_with_extension_and_contents('.html',%{<!DOCTYPE html>
+<html>
+  <body>
+    <h1>HELLO!</h1>
+    <h2>&amp; Goodbye</h2>
+  </body>
+</html>
+})
+    When render_file_url_code_block
+    Then {
+      assert_equal %{<pre><code class="language-html">&lt;!DOCTYPE html&gt;
+&lt;html&gt;
+  &lt;body&gt;
+    &lt;h1&gt;HELLO!&lt;/h1&gt;
+    &lt;h2&gt;&amp;amp; Goodbye&lt;/h2&gt;
+  &lt;/body&gt;
+&lt;/html&gt;
+</code></pre>},@html
+    }
+  end
+
+  test_that "a git url without a SHA1 or tag raises" do
+    Given a_git_repo_with_file("foo.rb")
+    When {
+      @code = -> {
+        Bookingit::Renderer.new.block_code(@file_git_url,nil)
+      }
+    }
+    Then {
+      assert_raises RuntimeError,&@code
+    }
+  end
+
+  test_that "a git url with a SHA1 gets that version" do
+    Given a_git_repo_with_two_verions_of_file("foo.rb")
+    When {
+      @parsed_versions = Hash[@versions.map { |sha1,_|
+        [sha1, Bookingit::Renderer.new.block_code(@file_git_url + "##{sha1}",nil)]
+      }]
+    }
+    Then {
+      @parsed_versions.each do |sha1,code|
+        assert_equal %{<pre><code class="language-ruby">#{@versions[sha1]}\n</code></pre>},code,"For SHA: #{sha1}"
+      end
+    }
+  end
+
+  test_that "a git url with a tag gets that version" do
+    Given a_git_repo_with_two_tagged_verions_of_file("foo.rb")
+    When {
+      @parsed_versions = Hash[@versions.map { |tagname,_|
+        [tagname, Bookingit::Renderer.new.block_code(@file_git_url + "##{tagname}",nil)]
+      }]
+    }
+    Then {
+      @parsed_versions.each do |tagname,code|
+        assert_equal %{<pre><code class="language-ruby">#{@versions[tagname]}\n</code></pre>},code,"For Tag: #{tagname}"
+      end
+    }
+  end
+
+  test_that "a git url with a diff spec shows the diff instead" do
+    Given a_git_repo_with_two_tagged_verions_of_file("foo.rb")
+    When {
+      url = @file_git_url + "#" + @versions.keys[0] + ".." + @versions.keys[1]
+      @html = Bookingit::Renderer.new.block_code(url,nil)
+    }
+    Then {
+      assert_match /<pre><code class=\"language-diff\">diff --git/,@html
+      assert_match /a\/foo.rb b\/foo.rb/,@html
+      assert_match /index [a-z0-9]+..[a-z0-9]+ 100644/,@html
+      assert_match /\-\-\- a\/foo.rb/,@html
+      assert_match /\+\+\+ b\/foo.rb/,@html
+    }
+  end
+
+  test_that "an sh url will run the given command and put the contents into the output" do
+    Given {
+      chdir @tempdir do
+        mkdir "play"
+        chdir "play" do
+          system "touch blah"
+          system "touch bar"
+          system "touch quux"
+        end
+      end
+    }
+    When {
+      @html = Bookingit::Renderer.new.block_code("sh://#{@tempdir}/play#ls -1",nil)
+    }
+    Then {
+      assert_equal %{<pre><code class="language-shell">&gt; ls -1
+bar
+blah
+quux
+</code></pre>},@html
+    }
+  end
+
+  test_that "we pass through inline code blocks" do
+    When {
+      @html = Bookingit::Renderer.new.block_code("class Foo", 'coffeescript')
+    }
+    Then {
+      assert_equal %{<pre><code class="language-coffeescript">class Foo</code></pre>},@html
+    }
+  end
+
+  test_that "we omit the language class if it's not provided in inline code" do
+    When {
+      @html = Bookingit::Renderer.new.block_code("class Foo", nil)
+    }
+    Then {
+      assert_equal %{<pre><code>class Foo</code></pre>},@html
+    }
+  end
+
+private
+
+  def create_and_commit_file(file,contents)
+    File.open(file,'w') do |file|
+      file.puts contents
+    end
+    system "git add .  #{devnull}"
+    system "git commit -m \"new file\" #{devnull}"
+    `git rev-parse HEAD`.chomp
+  end
+
+  def a_git_repo_with_two_verions_of_file(file)
+    -> {
+      @versions = {}
+      git_repo_in_tempdir do
+        code = %{class Foo
+  def initialize
+  end
+end}
+        2.times {
+          @versions[create_and_commit_file(file,code)] = code
+
+          code = %{class Foo
+  def initialize
+    @added = true
+  end
+end}
+        }
+        create_and_commit_file(file,code)
+        # make sure test doesn't get the HEAD version
+      end
+      @file_git_url = "git://#{File.join(@tempdir,'git_repo.git')}/#{file}"
+    }
+  end
+
+  def a_git_repo_with_two_tagged_verions_of_file(file)
+    -> {
+      @versions = {}
+      git_repo_in_tempdir do
+        code = %{class Foo
+  def initialize
+  end
+end}
+        2.times { |index|
+          create_and_commit_file(file,code)
+          tag = "tag-#{index}"
+          system "git tag #{tag} #{devnull}"
+
+          @versions[tag] = code
+
+          code = %{class Foo
+  def initialize
+    @added = true
+  end
+end}
+        }
+        create_and_commit_file(file,code)
+        # make sure test doesn't get the HEAD version
+      end
+      @file_git_url = "git://#{File.join(@tempdir,'git_repo.git')}/#{file}"
+    }
+  end
+
+  def git_repo_in_tempdir(&block)
+    chdir @tempdir do
+      mkdir 'git_repo'
+      chdir 'git_repo' do
+        system "git init #{devnull}"
+        system "git add . #{devnull}"
+        system "git commit -m \"initial commit\" #{devnull}"
+        block.()
+      end
+    end
+  end
+
+  def a_git_repo_with_file(file)
+    -> {
+      git_repo_in_tempdir do
+        @code = %{class Foo
+  def initialize
+  end
+end}
+        create_and_commit_file(file,@code)
+      end
+      @file_git_url = "git://#{File.join(@tempdir,'git_repo.git')}/#{file}"
+    }
+  end
+
+  def render_file_url_code_block
+    -> {
+      @html = Bookingit::Renderer.new.block_code("file://#{@path}",nil)
+    }
+  end
+
+  def a_file_with_extension_and_contents(extension,contents)
+    -> {
+      file = Tempfile.new(['foo',extension])
+      @path = file.path
+      @code = contents
+      File.open(@path,'w') do |file|
+        file.puts @code
+      end
+    }
+  end
+
+  def a_file_with_extension(extension)
+    a_file_with_extension_and_contents(extension,%{class SomeCode
+  def initialize(ohyeah)
+    @oh yeah = ohyeah
+  end
+end
+})
+  end
+
+  def devnull
+    return "" if ENV['DEBUG']
+    " 2>&1 > /dev/null"
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,14 @@
+require 'test/unit'
+require 'clean_test/test_case'
+require 'bookingit'
+
+# Add test libraries you want to use here, e.g. mocha
+
+class Test::Unit::TestCase
+  include Clean::Test::GivenWhenThen
+  include Clean::Test::TestThat
+  include Clean::Test::Any
+
+  # Add global extensions to the test case class here
+  
+end

metadata

@@ -0,0 +1,159 @@
+--- !ruby/object:Gem::Specification
+name: bookingit
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Dave Copeland
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-03-03 00:00:00.000000000 Z
+dependencies:
+- !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'
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  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: aruba
+  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: clean_test
+  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: gli
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: redcarpet
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: 
+email: davetron5000@gmail.com
+executables:
+- bookingit
+extensions: []
+extra_rdoc_files:
+- README.rdoc
+files:
+- ".gitignore"
+- ".ruby-gemset"
+- ".ruby-version"
+- Gemfile
+- Gemfile.lock
+- README.rdoc
+- Rakefile
+- bin/bookingit
+- bookingit.gemspec
+- features/bookingit.feature
+- features/step_definitions/bookinggit_steps.rb
+- features/support/env.rb
+- lib/bookingit.rb
+- lib/bookingit/config.rb
+- lib/bookingit/renderer.rb
+- lib/bookingit/version.rb
+- test/config_test.rb
+- test/renderer_test.rb
+- test/test_helper.rb
+homepage: http://www.naildrivin5.com
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options:
+- "--title"
+- bookingit
+- "--main"
+- README.rdoc
+- "-ri"
+require_paths:
+- lib
+- 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.0.rc.1
+signing_key: 
+specification_version: 4
+summary: Write a code-heavy book in Markdown
+test_files:
+- features/bookingit.feature
+- features/step_definitions/bookinggit_steps.rb
+- features/support/env.rb
+- test/config_test.rb
+- test/renderer_test.rb
+- test/test_helper.rb