specdown 0.1.2 → 0.1.3

data/CHANGELOG.markdown

@@ -1,5 +1,13 @@
 ## CHANGELOG
 
+## 0.1.3
+
+The `specdown` command now accepts two options: -h and -r. 
+
+    Usage: specdown [file1 [file2 [file3....]]]
+        -r, --root SPECDOWN_DIR          defaults to ./specdown
+        -h, --help                       Display this screen
+
 ## 0.1.2
 
 New feature added: test hooks. (see the README)

data/README.markdown

@@ -168,23 +168,29 @@ You can create test hooks that run before, after, and around tests. You can crea
 
 To create a global before hook, use the `Specdown.before` method:
 
-    Specdown.before do
-      puts "I run before every single test!"
-    end
+```ruby
+Specdown.before do
+  puts "I run before every single test!"
+end
+```
 
 That before hook will - you guessed it - RUN BEFORE EVERY SINGLE TEST.
 
 Similary, you can run some code after every single test via the `Specdown.after` method:
 
-    Specdown.after do
-      puts "I run after every single test!"
-    end
+```ruby
+Specdown.after do
+  puts "I run after every single test!"
+end
+```
 
 Whenever you need some code to run before _and_ after every single test, use the `Specdown.around` method:
 
-    Specdown.around do
-      puts "I run before _AND_ after every single test!"
-    end
+```ruby
+Specdown.around do
+  puts "I run before _AND_ after every single test!"
+end
+```
 
 ### Scoping your hooks to specific markdown files
 
@@ -192,18 +198,19 @@ You might, at times, want hooks to run only for certain files.
 
 You can pass filenames (or regular expressions) to the `Specdown.before`, `Specdown.after`, and `Specdown.around` methods. The hooks will then execute whenever you execute any markdown file with matching filenames.
 
-    Specdown.before "somefile.markdown", /^.*\.database.markdown$/ do
-      puts "This runs before every test within 'somefile.markdown', and
-            before every test in any markdown file whose filename ends 
-            with '.database.markdown'"
-    end
-
+```ruby
+Specdown.before "somefile.markdown", /^.*\.database.markdown$/ do
+  puts "This runs before every test within 'somefile.markdown', and
+        before every test in any markdown file whose filename ends 
+        with '.database.markdown'"
+end
+```
 
 ## TODO
 
 This library is the result of just a couple of days worth of work. It's a basic minimum viable product, but there are tons of features I want to implement. Here's what's on my immediate horizon:
 
-* Run a single test
+* Choose which files to run
 * color code the terminal output
 * offer the option of outputing the actual markdown while it executes, instead of "..F....FF......"
 * Better stack traces / reporting

data/bin/specdown

@@ -1,8 +1,4 @@
 #!/usr/bin/env ruby
 require 'specdown'
 
-Dir["./specdown/**/*.rb"].each do |ruby_file|
-  load ruby_file
-end
-
 Specdown::Command.new.execute

data/features/specdown_examples/scoped_hooks/specdown/hooks.rb

@@ -1,3 +1,4 @@
+puts "hooks loading!"
 Specdown.around /fun/ do
   puts "I run before and after fun tests."
 end

data/lib/specdown/command/option_parser.rb

@@ -0,0 +1,26 @@
+module Specdown
+  module OptionParser
+    extend self
+
+    def parse!
+      parser.parse!
+      Specdown::Config.tests = ARGV
+    end
+
+    private
+    def parser
+      ::OptionParser.new do |opts|
+        opts.banner = "Usage: specdown [file1 [file2 [file3....]]]"
+
+        opts.on '-r', '--root SPECDOWN_DIR', 'defaults to ./specdown' do |root|
+          Specdown::Config.root = root
+        end
+
+        opts.on '-h', '--help', 'Display this screen'  do
+          puts opts
+          exit
+        end
+      end
+    end
+  end
+end

data/lib/specdown/command.rb

@@ -1,17 +1,25 @@
 module Specdown
   class Command
-    def initialize
-      @markdowns = Dir["specdown/**/*.markdown"]
-    end
-
     def execute
+      parse_options
+      load_test_environment
       run
-      Specdown::EventServer.event :command_complete, @results
     end
     
     private
+    def parse_options
+      Specdown::OptionParser.parse!
+    end
+
+    def load_test_environment
+      Specdown::Config.test_environment_files.each do |file|
+        Kernel.load file
+      end
+    end
+
     def run
-      @results = @markdowns.map {|markdown| Runner.new(markdown).run.stats}
+      @results = Specdown::Config.tests.map {|markdown| Runner.new(markdown).run.stats}
+      Specdown::EventServer.event :command_complete, @results
     end
   end
 end

data/lib/specdown/config.rb

@@ -3,6 +3,39 @@ module Specdown
     extend self
 
     attr_accessor :expectations
+    attr_accessor :tests
+    attr_accessor :root
+    
+    def test_environment_files
+      unless @test_environment_files
+        @test_environment_files = Dir["#{root}/**/*.rb"]
+        unless root[0..0] == "/"
+          @test_environment_files.map! {|file| File.join Dir.pwd, file}
+        end
+      end
+
+      @test_environment_files
+    end
+    
+    def root
+      @root ||= "specdown"
+    end
+
+    def root=(new_root)
+      if new_root[-1..-1] == "/"
+        @root = new_root[0...-1]
+      else
+        @root = new_root
+      end
+    end
+
+    def tests
+      @tests ||= Dir["#{root}/**/*.markdown"] + Dir["#{root}/**/*.md"]
+    end
+
+    def tests=(test_files)
+      @tests = test_files unless test_files.empty?
+    end
 
     def reset!
       self.expectations = nil

data/lib/specdown.rb

@@ -1,4 +1,5 @@
 require 'kramdown'
+require 'optparse'
 require 'specdown/parser'
 require 'specdown/node'
 require 'specdown/tree'
@@ -19,3 +20,4 @@ require 'specdown/specdown'
 require 'specdown/sandbox_factory'
 require 'specdown/hooks'
 require 'specdown/hook'
+require 'specdown/command/option_parser'

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: specdown
 version: !ruby/object:Gem::Version 
-  hash: 31
+  hash: 29
   prerelease: 
   segments: 
   - 0
   - 1
-  - 2
-  version: 0.1.2
+  - 3
+  version: 0.1.3
 platform: ruby
 authors: 
 - Matt Parker
@@ -71,6 +71,7 @@ extra_rdoc_files:
 - CHANGELOG.markdown
 - README.markdown
 files: 
+- lib/specdown/command/option_parser.rb
 - lib/specdown/command.rb
 - lib/specdown/config.rb
 - lib/specdown/event_handlers/after_test.rb