gurk 0.0.1

data/.gitignore

@@ -0,0 +1,21 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+.rvmrc
+.ruby-version
+spec/support/testapp
+**.DS_Store

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format=doc

data/Gemfile

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

data/LICENSE.txt

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

data/README.md

@@ -0,0 +1,112 @@
+# Gurk
+
+A ruby microframework for the masses. You don't need a programming background all you need is the english language. 
+
+Perfect for designers or any developers that don't want to write code at all.
+
+## Installation
+
+    gem install gurk
+
+Create a new gurk project by running
+
+    gurk new <appname>
+    cd <appname>
+
+You should see a directory with the following structure
+
+    app/
+      assets/
+      views/
+      views/layouts/application.html.erb
+    features/
+    public/
+    vendor/
+    Gemfile
+
+## Features
+
+Create a basic feature file with the following
+
+    Given I have a home page
+    And with the path "/"
+    And with the title "Home Page"
+    And with the layout "
+
+More information and examples can be found at the Wiki.
+
+## Template Support
+
+Gurk supports Tilt. A template wrapper that gives you the flexibility to choose which
+
+If you're using haml, just add the following in your Gemfile
+
+    gem 'haml'
+
+Don't forget to run bundle install
+
+## Overiding generated pages
+
+For each page generated from the feature scenarios. We create an object that you can easily override. For this feature.
+
+
+    Given I have a home page
+    And with the path "/"
+    And with the title "Home Page"
+    And with the layout "
+
+Add a file called app/home.rb
+
+   class HomePage
+     include Gurk::Methods
+
+     local :page_title, 'This is the new title' 
+     local :header, 'The most awesome site ever'
+
+     path '/homepage'
+
+   end
+
+## Creating your own pages
+
+Ok fine, you don't want to use the features feature. You are free to do so by doing the following
+
+Create a file called app/contact.rb
+
+   class ContactPage
+     include Gurk::Methods
+
+     name 'contact'
+     local :title, "Contact Page"
+     path '/contact'
+
+   end
+
+Don't forget to create your view. For example: app/views/contact.html.erb 
+
+Then register it to Gurk in your app.rb file.
+
+    Gurk::Router.register ContactPage
+
+## Tests
+
+Gurk supports tests! In fact we do sanity check per each request during development.
+
+## 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
+
+
+## Contributors
+
+Vixon
+
+## License
+
+MIT License
+
+

data/Rakefile

@@ -0,0 +1,7 @@
+require "bundler/gem_tasks"
+
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/gurk

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+# -*- mode: ruby -*-
+
+# $LOAD_PATH << File.join(File.dirname(__FILE__), '..', 'lib')
+
+require 'gurk/runner'
+Gurk::Runner.start

data/gurk.gemspec

@@ -0,0 +1,30 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'gurk/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "gurk"
+  spec.version       = Gurk::VERSION
+  spec.authors       = ["Vixon"]
+  spec.email         = ["vixonshow@gmail.com"]
+  spec.description   = %q{Gurk}
+  spec.summary       = %q{A plain english ruby microframework that makes sense}
+  spec.homepage      = "http://github.com/vixon/gurk"
+  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 "rake"
+  spec.add_development_dependency "rspec"
+  spec.add_development_dependency "rack-test"
+
+  spec.add_dependency "gherkin"
+  spec.add_dependency 'http_router', '~> 0.11.0'
+  spec.add_dependency 'tilt'
+  spec.add_dependency 'thor'
+end

data/lib/gurk.rb

@@ -0,0 +1,65 @@
+require "gurk/version"
+require "gurk/router"
+require "gurk/parser"
+require "gurk/page"
+require "tilt"
+require "tilt/erb"
+
+module Gurk
+
+  Tilt.register Tilt::ERBTemplate, '.html.erb'
+
+  def self.root
+    Dir.pwd
+  end
+
+  # The default template
+  @@default_view_engine = :erb
+
+  def self.default_view_engine
+    @@default_view_engine
+  end
+
+  def self.default_view_engine=(new_default_view_engine)
+    @@default_view_engine = new_default_view_engine
+  end
+
+  # The default view path
+  @@view_path = self.root + "/app/views"
+
+  def self.view_path
+    @@view_path 
+  end
+
+  def self.view_path=(new_view_path)
+    @@view_path = new_view_path
+  end
+
+  @@feature_paths = Dir.glob("#{Dir.pwd}/features/*.feature")
+
+  def self.feature_paths
+    @@feature_paths   
+  end
+
+  def self.feature_paths=(new_feature_path)
+    @@feature_paths = new_feature_path
+  end
+
+  @@router ||= Gurk::Router.new
+
+  def self.router
+    @@router
+  end
+
+  def self.run
+    puts self.feature_paths
+    parsed = Gurk::Parser.new(self.feature_paths).parse!
+
+    parsed.each do |p|
+      router.add Gurk::Page.new(p)
+    end
+
+    self.router
+  end
+
+end

data/lib/gurk/cli.rb

@@ -0,0 +1,21 @@
+require 'thor'
+module Gurk
+  class Cli < Thor::Group
+    include Thor::Actions
+
+    argument :name
+   
+    def self.source_root
+      File.dirname(__FILE__) 
+    end
+
+    def setup
+      directory "../templates", name, recursive: true
+    end
+
+    def bundle_install
+      system("cd #{name} && bundle install")
+    end
+
+  end
+end

data/lib/gurk/page.rb

@@ -0,0 +1,71 @@
+require 'erb'
+require 'tilt'
+
+module Gurk
+  class Page
+    attr_accessor :name, :route, :locals, :layout
+
+    def initialize(data)
+      @name = data[:name].downcase
+      @locals = data[:locals]
+      @route = data[:route]
+      @layout= data[:locals][:layout] if data[:locals] && data[:locals][:layout]
+    end  
+
+    def render(env)
+      output = nil
+
+      if @layout
+        output = render_template_with_layout(env) do
+          render_template(env)
+        end
+      else
+        output = render_template(env)
+      end
+
+      [200, {'content_type' => 'text/html'}, [output]]
+
+    rescue Errno::ENOENT => e
+      raise Gurk::TemplateNotFound.new(e)  
+    rescue RuntimeError, Exception => e
+      # TODO: Make this more sensible
+      raise e
+    end
+
+    def render_template_with_layout(env, &block)
+      tilt = Tilt.new(layout_path)
+      tilt.render(nil, locals) do
+        yield
+      end
+    end
+
+    def render_template(env)
+      tilt = Tilt.new(view_path)
+      tilt.render(nil, locals) 
+    end
+
+    def view_name
+      @view_name ||= @name
+    end 
+
+    def view_path
+      Gurk.view_path + '/' + view_name + '.' + Gurk.default_view_engine.to_s
+    end
+    
+    def layout_name
+      @locals[:layout]
+    end
+
+    def layout_path
+      if layout_name =~ /\.(erb|haml|)/
+        Gurk.view_path + '/' + layout_name
+      else
+        Gurk.view_path + '/' + layout_name + '.' + Gurk.default_view_engine.to_s
+      end
+    end
+
+  end
+end
+
+class Gurk::TemplateNotFound < Exception; end
+class Gurk::TemplateEngineNotFound < Exception; end

data/lib/gurk/parser.rb

@@ -0,0 +1,82 @@
+require 'gherkin/parser/parser'
+require 'gherkin/formatter/json_formatter'
+require 'stringio'
+require 'multi_json'
+
+module Gurk
+  class Parser
+    VALID_STEPS = [
+      { "^I have a page called '(.+)'$" => lambda { |k, _| { name: k } } },
+      { "^it has a route of '(.+)'$" => lambda { |k, _| { route: k } } },
+      { "^it has a (.+) called '(.+)'$" => lambda { |k, v| { k.to_sym => v } } }
+    ]
+
+    attr_accessor :sources
+
+    def initialize(sources = Dir.glob("#{Dir.pwd}/features/*.feature"))
+      @parsed_names = []
+      @parsed_data = []
+      @sources = sources
+      io = StringIO.new
+      formatter = Gherkin::Formatter::JSONFormatter.new(io)
+      parser = Gherkin::Parser::Parser.new(formatter)
+      read_feature_files(io, parser, formatter, sources)
+    end
+
+    def parse!
+      @parsed_names.each { |name| parse_names(name) }
+      parse_locals(@parsed_data)
+    end
+
+  private
+
+    def read_feature_files(io, parser, formatter, sources)
+      sources.each { |s| parser.parse(IO.read(s), s, 0) }
+      formatter.done
+      process_data(MultiJson.load(io.string))
+    end
+
+    def process_data(data)
+      data.each { |feature| extract_steps_from feature['elements'] }
+    end
+
+    def extract_steps_from(element_nodes)
+      element_nodes.each { |element_node| @parsed_names << extract_names_from(element_node['steps']) }
+    end
+
+    def extract_names_from(steps)
+      [].tap { |name| steps.each { |step| name << step['name'] } }
+    end
+
+    def parse_names(name)
+      @parsed_data << name.map { |match| parse_steps(match) }.flatten.compact
+    end
+
+    def parse_steps(match)
+      VALID_STEPS.map { |step| step.values.first.call($1, $2) if /#{step.keys.first}/ =~ match }
+    end
+
+    def parse_locals(steps)
+      @parsed_data = [].tap do |data|
+        steps.map do |step|
+          locals = sanitize(step)
+          step << { locals: extract_locals_from(step, locals) }
+          data << merge_steps(step)
+        end
+      end
+    end
+
+    def sanitize(step)
+      step.dup.reject! { |h| h.key?(:route) || h.key?(:name) }
+    end
+
+    def extract_locals_from(step, locals)
+      step.reject! { |h| h == locals.first }
+      locals.first
+    end
+
+    def merge_steps(step)
+      {}.tap { |data| step.each { |h| data.merge! h } }
+    end
+  end
+end

data/lib/gurk/router.rb

@@ -0,0 +1,31 @@
+require 'http_router'
+
+module Gurk
+  class Router
+
+    def initialize
+      http_router
+    end
+
+    def http_router
+      @http_router ||= HttpRouter.new
+    end
+
+    def add(page)
+      routes.push(page)
+      http_router.add(page.route).to { |env| 
+        page.render env
+      }
+    end
+
+    def routes
+      @routes ||= []
+    end
+
+    def call(env)
+      http_router.call(env)
+    end
+
+  end
+end
+

data/lib/gurk/runner.rb

@@ -0,0 +1,25 @@
+require 'thor'
+require 'gurk/cli'
+
+module Gurk
+
+  class Runner < Thor
+
+    map "-T" => :list, "-i" => :install, "-u" => :update, "-v" => :version
+
+    desc "new app_name", "Generates a new Gurk application"
+    method_options :as => :string, :relative => :boolean, :force => :boolean
+    def new(name)
+      Gurk::Cli.new([name]).setup
+      say "New Gurk app generated. Now start Gurkin!"
+    end
+
+    desc "version", "Show Gurk version"
+    def version
+      require 'thor/version'
+      say "Gurk #{Gurk::VERSION}"
+    end
+
+  end
+
+end

data/lib/gurk/version.rb

@@ -0,0 +1,3 @@
+module Gurk
+  VERSION = "0.0.1"
+end

data/lib/templates/Gemfile

@@ -0,0 +1,13 @@
+source 'https://rubygems.org'
+
+gem 'gurk'
+
+# Uncomment if you want to use haml
+# gem 'haml'
+
+# Uncomment if you want to use cucumber
+
+# group :test do
+#   gem 'cucumber'
+#   gem 'rack-test'
+# end

data/lib/templates/app.rb

@@ -0,0 +1,6 @@
+require 'bundler'
+Bundler.setup
+Bundler.require
+
+require 'gurk'
+App = Gurk.run

data/lib/templates/config.ru

@@ -0,0 +1,3 @@
+require './app'
+
+run App = Gurk.run

data/lib/templates/features/home.feature

@@ -0,0 +1,15 @@
+Feature: My site
+
+  Scenario: Home Page
+    Given I have a page called 'Home'
+    And it has a title called 'home'
+    And it has a route of '/'
+    When I visit '/'
+    Then I should see 'home'
+
+  Scenario: About
+    Given I have a page called 'About'
+    And it has a title called 'About Us'
+    And it has a route of '/about'
+    When I visit '/about'
+    Then I should see 'About Us'

data/spec/example/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gem 'gurk', path: '../../'

data/spec/example/app.rb

@@ -0,0 +1,6 @@
+require 'bundler'
+Bundler.setup
+Bundler.require
+
+require 'gurk'
+App = Gurk.run

data/spec/example/app/views/about.erb

@@ -0,0 +1,11 @@
+<html>
+  <title><%= title %></title>
+
+  <body>
+    <p>Hey You,</p>
+    <p>Keep being awesome. Because being awesome is awesome.</p>
+    <p>- You</p>
+
+  </body>
+    
+</html>

data/spec/example/app/views/home.erb

@@ -0,0 +1,11 @@
+<html>
+  <title><%= title %></title>
+
+  <body>
+    <p>Hey You,</p>
+    <p>Keep being awesome. Because being awesome is awesome.</p>
+    <p>- You</p>
+
+  </body>
+    
+</html>

data/spec/example/config.ru

@@ -0,0 +1,3 @@
+require './app'
+
+run App = Gurk.run

data/spec/example/features/home.feature

@@ -0,0 +1,15 @@
+Feature: My site
+
+  Scenario: Home Page
+    Given I have a page called 'Home'
+    And it has a title called 'home'
+    And it has a route of '/'
+    When I visit '/'
+    Then I should see 'home'
+
+  Scenario: About
+    Given I have a page called 'About'
+    And it has a title called 'About Us'
+    And it has a route of '/about'
+    When I visit '/about'
+    Then I should see 'About Us'

data/spec/gurk/cli_spec.rb

@@ -0,0 +1,33 @@
+require 'spec_helper'
+
+describe Gurk::Cli do
+
+  let(:sample_directory) {
+    File.join(Dir.pwd, "spec", "support", "testapp")
+  }
+
+  before do
+    FileUtils.rm_rf sample_directory
+
+    ARGV.replace []
+    ARGV << sample_directory
+
+    cli = Gurk::Cli.new ARGV
+    cli.setup
+  end
+
+  describe "#setup" do
+
+    it 'creates the app directory' do     
+      expect(File.exists?(sample_directory)).to be_true
+    end
+
+    it 'creates individual app files' do
+      expect(File.exists?(File.join(sample_directory, 'config.ru'))).to be_true
+      expect(File.exists?(File.join(sample_directory, 'app.rb'))).to be_true
+    end
+ 
+  end
+
+end
+

data/spec/gurk/example_spec.rb

@@ -0,0 +1,27 @@
+require 'rack/test'
+require File.join(File.dirname(__FILE__), '/../example/app.rb')
+
+include Rack::Test::Methods
+
+describe 'Gurk::Example' do
+
+  before do
+    Gurk.stub(:view_path).and_return File.join('spec', 'example', 'app', 'views')
+    Gurk.stub(:feature_paths).and_return Dir.glob("#{Dir.pwd}/spec/example/features/*.feature")
+
+    request '/'
+  end
+
+  def app
+    Gurk.run
+  end
+
+  it 'returns homepage successfully' do
+    expect(last_response.status).to eq(200)
+  end
+
+  it 'shows the title' do
+    expect(last_response.body).to include ('home')
+  end
+
+end

data/spec/gurk/gurk_spec.rb

@@ -0,0 +1,22 @@
+require 'spec_helper'
+
+include Rack::Test::Methods
+
+describe Gurk do
+
+  describe '#run' do
+
+    before do
+      Gurk.stub(:feature_paths).and_return  Dir.glob("#{Dir.pwd}/spec/support/*.feature")
+      Gurk.run
+    end
+
+    it 'creates routes from the array' do
+      expect(Gurk.router.routes.length).to_not be_zero
+    end
+
+  end
+
+end
+
+

data/spec/gurk/page_spec.rb

@@ -0,0 +1,56 @@
+require 'spec_helper'
+
+describe Gurk::Page do
+
+  describe '#pages' do
+
+    Gurk.view_path = File.join(Dir.pwd, 'spec', 'support', 'views')
+
+    let(:page) { 
+      Gurk::Page.new({name: 'about', path: '/pages/slug', locals: {title: 'lalala'}})
+    }
+
+    it 'returns the view name' do
+      expect(page.view_name).to eq('about')
+    end
+
+    context "nolayout" do
+      it 'returns the layout name' do
+        expect(page.layout_name).to be_nil
+      end
+    end
+
+    context "with a layout" do
+      it 'returns the layout name' do
+        page.locals.merge!(layout: 'wat')
+        expect(page.layout_name).to eq 'wat'
+      end
+    end
+  end
+
+  describe '#render' do
+
+    it 'render the page' do
+      page = Gurk::Page.new({name: 'about', path: '/pages/slug', locals: {title: 'lalala'}})
+      result = page.render nil
+      expect(result.last.first).to include 'lalala'
+    end
+
+    it 'renders the page with the layout' do
+      page = Gurk::Page.new({name: 'about', path: '/pages/slug', locals: {title: 'lalala', layout: 'layout.erb'}})
+      result = page.render nil
+
+      expect(result.last.first).to include 'This is the layout'
+      expect(result.last.first).to include 'lalala'
+    end
+
+    it 'raises an exception if the template is invalid' do
+      page = Gurk::Page.new({name: 'aboutlalala', path: '/pages/slug', locals: {title: 'lalala'}})
+      expect {
+        page.render nil
+      }.to raise_exception(Gurk::TemplateNotFound)
+    end
+
+  end
+
+end

data/spec/gurk/parser_spec.rb

@@ -0,0 +1,210 @@
+require 'spec_helper'
+
+describe Gurk::Parser do
+
+  let(:sources) do
+    #Dir.glob("#{Dir.pwd}/spec/support/*.feature")
+    [ "#{Dir.pwd}/spec/support/another_example.feature", "#{Dir.pwd}/spec/support/example.feature" ]
+  end
+
+  let(:parsed_data) do
+    [
+      { :name => "About", :route => "/about", :locals => { :title=>"about" } },
+      { :name => "Home", :route => "/", :locals => { :title => "home" } }
+    ]
+  end
+
+  let(:steps) do
+     [ ["I have a page called 'About'",
+     "it has a title called 'about'",
+     "it has a route of '/about'",
+     "I visit '/about'",
+     "I should see 'about'",],
+     ["I have a page called 'Home'",
+     "it has a title called 'home'",
+     "it has a route of '/'",
+     "I visit '/'",
+     "I should see 'home'"] ]
+  end
+
+  let(:parsed_steps) do
+    [ {"keyword"=>"Given ", "name"=>"I have a page called 'About'", "line"=>4},
+      {"keyword"=>"And ", "name"=>"it has a title called 'about'", "line"=>5},
+      {"keyword"=>"And ", "name"=>"it has a route of '/about'", "line"=>6},
+      {"keyword"=>"When ", "name"=>"I visit '/about'", "line"=>7},
+      {"keyword"=>"Then ", "name"=>"I should see 'about'", "line"=>8}]
+    [ {"keyword"=>"Given ", "name"=>"I have a page called 'Home'", "line"=>4},
+      {"keyword"=>"And ", "name"=>"it has a title called 'home'", "line"=>5},
+      {"keyword"=>"And ", "name"=>"it has a route of '/'", "line"=>6},
+      {"keyword"=>"When ", "name"=>"I visit '/'", "line"=>7},
+      {"keyword"=>"Then ", "name"=>"I should see 'home'", "line"=>8}]
+  end
+
+  let(:parsed_names) do
+    [ ["I have a page called 'About'",
+       "it has a title called 'about'",
+       "it has a route of '/about'",
+       "I visit '/about'",
+       "I should see 'about'"],
+       ["I have a page called 'Home'",
+        "it has a title called 'home'",
+        "it has a route of '/'",
+        "I visit '/'",
+        "I should see 'home'"] ]
+  end
+
+  describe '#initialize' do
+    it 'reads existing feature files' do
+      Gurk::Parser.any_instance.should_receive(:read_feature_files)
+      Gurk::Parser.new(sources)
+    end
+  end
+
+  describe '#parse!' do
+    it 'parses each set of names extracted from the feature files' do
+      Gurk::Parser
+        .any_instance
+        .should_receive(:parse_names)
+        .exactly(parsed_names.length)
+        .times
+      Gurk::Parser.new(sources).parse!
+    end
+
+    it 'passes the parsed data to #parse_locals' do
+      parser = Gurk::Parser.new(sources)
+      Gurk::Parser
+        .any_instance
+        .should_receive(:parse_locals)
+        .with(parser.instance_variable_get :@parsed_data)
+      parser.parse!
+    end
+
+    it 'returns a hash with the correct format' do
+      expect(Gurk::Parser.new(sources).parse!).to eq parsed_data
+    end
+  end
+
+  describe 'private methods' do
+    let(:parser) { Gurk::Parser.new(sources) }
+
+    describe '#read_feature_files' do
+      it 'parses the feature files' do
+        Gherkin::Parser::Parser
+          .any_instance
+          .should_receive(:parse)
+          .exactly(parsed_names.length)
+          .times
+        Gurk::Parser.new(sources)
+      end
+
+      it 'passes the result to #process_data' do
+        Gurk::Parser.any_instance.should_receive(:process_data)
+        Gurk::Parser.new(sources)
+      end
+    end
+
+    describe '#process_data' do
+      it 'finds all "elements" nodes in the given data and passes it to #extract_steps_from' do
+        Gurk::Parser
+          .any_instance
+          .should_receive(:extract_steps_from)
+          .twice # Two 'element' nodes
+        Gurk::Parser.new(sources)
+      end
+    end
+
+    describe '#extract_steps_from' do
+      it 'finds all "steps" nodes in the given data and passes it to #extract_names_from' do
+        Gurk::Parser
+          .any_instance
+          .should_receive(:extract_names_from)
+          .twice # Two 'steps' nodes
+        Gurk::Parser.new(sources)
+      end
+
+      it 'saves the return value of #extract_names_from' do
+        expect(parser.instance_variable_get :@parsed_names).to eq parsed_names
+      end
+    end
+
+    describe '#extract_names_from' do
+      it 'finds and returns all "name" nodes from the given data' do
+        expect(parser.send(:extract_names_from, parsed_steps)).to eq parsed_names.last
+      end
+    end
+
+    describe '#parse_names' do
+      it 'passes the given data to #parse_steps' do
+        Gurk::Parser
+          .any_instance
+          .should_receive(:parse_names)
+          .exactly(parsed_names.length)
+          .times
+        Gurk::Parser.new(sources).parse!
+      end
+    end
+
+    describe '#parse_steps' do
+      context 'with a matching step' do
+        it 'returns the parsed step' do
+          expect(parser.send(:parse_steps, "I have a page called 'About'")).to include name: 'About'
+        end
+      end
+
+      context 'with a non-matching step' do
+        it 'returns an array of nils' do
+          expect(parser.send(:parse_steps, "I visit '/about'")).to eq [nil, nil, nil]
+        end
+      end
+    end
+
+    describe '#parse_locals' do
+      let(:step) { [[{:name=>"About"}, {:title=>"about"}, {:route=>"/about"}]] }
+
+      it 'passes each given step to #sanitize' do
+        parser.stub(:extract_locals_from)
+        parser.should_receive(:sanitize)
+        parser.send :parse_locals, step
+      end
+
+      it 'passes sanitized steps to #extract_locals_from' do
+        parser.should_receive(:extract_locals_from)
+        parser.send :parse_locals, step
+      end
+
+      it 'passes extracted locals to #merge_steps' do
+        parser.should_receive(:merge_steps)
+        parser.send :parse_locals, step
+      end
+
+      it 'returns the result of the parsing' do
+        result = [{:name=>"About", :route=>"/about", :locals => {:title=>"about"}}]
+        parser.instance_variable_set(:@parsed_data, step)
+        expect(parser.send :parse_locals, step).to eq result
+      end
+    end
+
+    describe '#sanitize' do
+      it 'returns local variable pairs' do
+        step = [{:name=>"About"}, {:title=>"about"}, {:route=>"/about"}]
+        expect(parser.send :sanitize, step).to eq [{:title=>"about"}]
+      end
+    end
+
+    describe '#extract_locals_from' do
+      it 'returns parsed locals' do
+        step = [[{:name=>"About"}, {:title=>"about"}, {:route=>"/about"}]]
+        local = [{:title=>"about"}]
+        expect(parser.send :extract_locals_from, step, local).to eq local.first
+      end
+    end
+
+    describe '#merge_steps' do
+      it 'returns merged steps' do
+        step = [{:name=>"About"}, {:route=>"/about"}, {:locals=>[{:title=>"about"}]}]
+        result = { :name => "About", :route => "/about", :locals => [ { :title=>"about" } ] }
+        expect(parser.send :merge_steps, step).to eq result
+      end
+    end
+  end
+end

data/spec/gurk/router_spec.rb

@@ -0,0 +1,44 @@
+require File.join(File.dirname(__FILE__), '/../', 'spec_helper')
+
+include Rack::Test::Methods
+
+describe Gurk::Router do
+
+  before do
+    @router = Gurk::Router.new
+  end
+
+  def app
+    @router
+  end
+
+  it 'returns a valid instance' do
+    expect(@router).to be_instance_of Gurk::Router
+  end
+
+  it 'returns a valid http_router instance' do
+    expect(@router.http_router).to be_instance_of HttpRouter
+  end
+
+  it 'adds a page with a valid content' do
+    page = Gurk::Page.new({name: 'about', path: '/about', locals: {title: 'lalala'}})
+
+    @router.add page
+
+    request "/about"
+
+    expect(last_response.status).to eq(200)
+  end
+
+  it 'adds a page with a valid content with params' do
+
+    page = Gurk::Page.new({name: 'about', path: '/pages/slug', locals: {title: 'lalala'}})
+
+    @router.add page
+
+    request '/pages/this-is-a-slug'
+
+    expect(last_response.status).to eq(200)
+  end
+ 
+end

data/spec/spec_helper.rb

@@ -0,0 +1,8 @@
+require 'gurk'
+require 'gurk/router'
+require 'gurk/page'
+require 'gurk/parser'
+require 'gurk/cli'
+
+require 'rack/test'
+

data/spec/support/another_example.feature

@@ -0,0 +1,8 @@
+Feature: About Page
+
+  Scenario:
+    Given I have a page called 'About'
+    And it has a title called 'about'
+    And it has a route of '/about'
+    When I visit '/about'
+    Then I should see 'about'

data/spec/support/example.feature

@@ -0,0 +1,8 @@
+Feature: Home Page
+
+  Scenario:
+    Given I have a page called 'Home'
+    And it has a title called 'home'
+    And it has a route of '/'
+    When I visit '/'
+    Then I should see 'home'

data/spec/support/example_with_layout.feature

@@ -0,0 +1,10 @@
+Feature: Home Page
+
+  Scenario:
+    Given I have a page called 'Home'
+    And it has a title called 'home'
+    And it has a layout called 'home'
+    And it has a template called 'home.html.erb'
+    And it has a route of '/'
+    When I visit '/'
+    Then I should see 'home'

data/spec/support/views/about.erb

@@ -0,0 +1 @@
+Title: <%= title %>

data/spec/support/views/layout.erb

@@ -0,0 +1,6 @@
+<html>
+<body>
+  <p>This is the layout</p>
+  <div><%= yield %></div>
+</body>
+</html>

metadata

@@ -0,0 +1,192 @@
+--- !ruby/object:Gem::Specification
+name: gurk
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Vixon
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-09-17 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: &70173898733100 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: *70173898733100
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: &70173898732340 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70173898732340
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &70173898731580 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70173898731580
+- !ruby/object:Gem::Dependency
+  name: rack-test
+  requirement: &70173898731080 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70173898731080
+- !ruby/object:Gem::Dependency
+  name: gherkin
+  requirement: &70173898730580 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70173898730580
+- !ruby/object:Gem::Dependency
+  name: http_router
+  requirement: &70173898729900 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.11.0
+  type: :runtime
+  prerelease: false
+  version_requirements: *70173898729900
+- !ruby/object:Gem::Dependency
+  name: tilt
+  requirement: &70173898729400 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70173898729400
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: &70173898728840 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70173898728840
+description: Gurk
+email:
+- vixonshow@gmail.com
+executables:
+- gurk
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/gurk
+- gurk.gemspec
+- lib/gurk.rb
+- lib/gurk/cli.rb
+- lib/gurk/page.rb
+- lib/gurk/parser.rb
+- lib/gurk/router.rb
+- lib/gurk/runner.rb
+- lib/gurk/version.rb
+- lib/templates/Gemfile
+- lib/templates/app.rb
+- lib/templates/app/views/home.erb
+- lib/templates/app/views/layout.erb
+- lib/templates/config.ru
+- lib/templates/features/home.feature
+- spec/example/Gemfile
+- spec/example/app.rb
+- spec/example/app/views/about.erb
+- spec/example/app/views/home.erb
+- spec/example/config.ru
+- spec/example/features/home.feature
+- spec/gurk/cli_spec.rb
+- spec/gurk/example_spec.rb
+- spec/gurk/gurk_spec.rb
+- spec/gurk/page_spec.rb
+- spec/gurk/parser_spec.rb
+- spec/gurk/router_spec.rb
+- spec/spec_helper.rb
+- spec/support/another_example.feature
+- spec/support/example.feature
+- spec/support/example_with_layout.feature
+- spec/support/views/about.erb
+- spec/support/views/layout.erb
+homepage: http://github.com/vixon/gurk
+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'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.15
+signing_key: 
+specification_version: 3
+summary: A plain english ruby microframework that makes sense
+test_files:
+- spec/example/Gemfile
+- spec/example/app.rb
+- spec/example/app/views/about.erb
+- spec/example/app/views/home.erb
+- spec/example/config.ru
+- spec/example/features/home.feature
+- spec/gurk/cli_spec.rb
+- spec/gurk/example_spec.rb
+- spec/gurk/gurk_spec.rb
+- spec/gurk/page_spec.rb
+- spec/gurk/parser_spec.rb
+- spec/gurk/router_spec.rb
+- spec/spec_helper.rb
+- spec/support/another_example.feature
+- spec/support/example.feature
+- spec/support/example_with_layout.feature
+- spec/support/views/about.erb
+- spec/support/views/layout.erb