noumenon 0.0.1

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/.travis.yml

@@ -0,0 +1,6 @@
+rvm:
+  - 1.8.7
+  - 1.9.2
+  - ree
+  - rbx
+  - jruby

data/Gemfile

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

data/README.md

@@ -0,0 +1,85 @@
+# Noumenon
+
+Noumenon: Noun. The intellectual conception of a thing as it is in itself, not as it is known through perception.
+
+## What is This Thing?
+
+Noumenon is a web application based on Sinatra for constructing dynamic websites which use a Git repository
+for storing all content. It's designed to allow technical and non-technical teams to collaborate on development and
+populate of a content management system using the tools they are most comfortable with.
+
+In the case of developers (and some designers) that's version control and text editors, while in the case of content
+editors thats more likely to be a web interface.
+
+## How it Works
+
+The URL structure and content of a Noumenon site is defined by a Git repository, similar to the structure below:
+
+    /
+    - /config.rb
+    - /index.html
+    - /about
+      - /people.html
+      - /company.html
+    - /contact
+      - /config.rb
+    - /blog
+      - /config.rb
+      - /posts/2011-04-18-an-example-post.md
+      - /posts/2011-04-10-another-example.md
+
+This git repository is then provided to Noumenon as it's data source. On startup it loads any file called "config.rb"
+and uses it to determine how that directory should behave:
+
+    # /config.rb
+    domain      "example.org"
+    application "git://github.com/noumenon/apps-static"
+    theme       "git://github.com/noumenon/themes-example"
+
+That example configures Noumenon to use the "Noumenon::Static" application to serve any templates below that point as
+a static page.
+
+    # /contact/config.rb
+    application           "git://github.com/noumenon/apps-contact"
+    contact.email_address "info@example.org"
+
+While the one in /contact specifies that "Noumenon::Contact" should be used to provide the URL tree below /contact, in this
+case a contact form which emails any responses to the specified address.
+
+Finally /blogs/config.rb might look something like this:
+
+    application   "git://github.com/noumenon/apps-blog"
+    blog.comments true
+
+## Hosting a Noumenon Site
+
+*This won't work yet: I havn't implemented automatic check out of a content repository.*
+
+To host a site you will need to have Ruby and an application server such as Passenger, Unicorn or Thin. Due it's interactions
+with git as a data store Heroku is not a supported platform for hosting, although I'm sure someone will find a way around that.
+
+Install Noumenon: `gem install noumenon`
+
+Create a directory, and put the following config.ru in it:
+
+    require 'noumenon'
+    Noumenon::Core.set :content_repository, "git@github.com:Noumenon/example.git"
+    
+    run Noumenon.boot
+
+And then set up your application server to provide that application. On startup it will first attempt to check out the content
+repository, then it will parse any configuration files, and install any required dependencies. Finally, it will start hosting
+the site.
+
+To update the content repository restart your application server, which will cause it to update the repository, and any dependencies.
+
+### Hosting on Heroku
+
+The someone who worked out the way around it was me it seems. This will only work if you're deploying an entirely static site,
+if you need the admin section to work then you'll have to host somewhere else, but otherwise, use a config.ru like this, and make
+sure you have Noumenon in your Gemfile:
+
+    require 'noumenon'
+    Noumenon::Core.set :content_repository_path, File.expand_path("..", __FILE__)
+    
+    run Noumenon.boot

data/Rakefile

@@ -0,0 +1,9 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+task :default => "specs"
+
+desc "Run all specs"
+task "specs" do
+  exec "rspec spec"
+end

data/lib/noumenon.rb

@@ -0,0 +1,53 @@
+require 'noumenon/configuration'
+require 'noumenon/template'
+require 'noumenon/core'
+
+module Noumenon
+  class TemplateNotFoundError < StandardError; end
+  
+  class << self
+    # Returns a configured Noumenon application. Intended for use in a Rack configuration:
+    #
+    # Example:
+    #
+    #   require 'noumenon'
+    #   Noumenon::Core.set :content_repository_path, "/srv/sites/example.org"
+    #
+    #   run Noumenon.boot
+    def boot
+      Rack::Builder.new do
+        Dir.glob(File.join(Noumenon.config.dependencies_path, "themes/*/assets")).each do |path|
+          theme = path.split("/")[-2]
+          url = "/themes/#{theme}"
+          
+          map(url) { run Rack::File.new(path) }
+        end
+        
+        map("/") { run Core.new }
+      end
+    end
+    
+    # Provides access to the configuration of this application.
+    #
+    # If passed a block then the current configuration will be yielded in the form
+    # of a Noumenon::Configuration instance, allowing it to be changed.
+    #
+    #     Noumenon.config do |c|
+    #       c.theme = "example_theme"
+    #     end
+    #
+    def config
+      @config ||= Configuration.new
+      yield @config if block_given?
+      @config
+    end
+    alias :configure :config
+    
+    # Set the application configuration
+    #
+    # Should be provided with something that implements the same interface as Noumenon::Configuration.
+    def config=(config)
+      @config = config
+    end
+  end
+end

data/lib/noumenon/configuration.rb

@@ -0,0 +1,26 @@
+module Noumenon
+  # Handles configuration for a Noumenon application.
+  class Configuration
+    class ThemeNotFoundError < StandardError; end
+    
+    # The path to load content from.
+    attr_accessor :content_repository_path
+
+    # The path to load any depdencies such as themes and applications from.
+    attr_accessor :dependencies_path
+
+    # The theme to use.
+    attr_accessor :theme
+    
+    # Sets the current theme.
+    #
+    # If the theme could not be found under dependencies_path then a ThemeNotFoundError will be raised.
+    def theme=(value)
+      unless File.exist?(File.join(dependencies_path, "themes", value))
+        raise ThemeNotFoundError.new("The theme #{value} could not be found in #{dependencies_path}/themes.")
+      end
+      
+      @theme = value
+    end
+  end
+end

data/lib/noumenon/core.rb

@@ -0,0 +1,93 @@
+require 'sinatra'
+require 'liquid'
+require 'yaml'
+
+# :nodoc:
+module Noumenon
+  # The base of all Noumenon sites, responsible for building the URL structure, and providing
+  # access to the content repository.
+  #
+  # By default any request will be routed to the content repository to find an item of content
+  # using #locate_content, which will then be rendered using the template specified by the content
+  # file.
+  #
+  # A piece of content takes the form of a YAML file, which should provide any fields required by
+  # template specified. If any required fields are missing then a MissingContentError will be raised.
+  #
+  class Core < Sinatra::Base
+    def config
+      Noumenon.config
+    end
+    
+    # Get the path to a file in the content repository.
+    def content_path(path)
+      File.join(config.content_repository_path, path)
+    end
+    
+    # Get the path to a file provided by the current theme.
+    def theme_path(path)
+      File.join(config.dependencies_path, "themes", config.theme, path)
+    end
+    
+    # Render a template, surrounding it with the theme layout if a theme has been set, and 
+    # it provides a layout.
+    #
+    # Any locals provided will be passed onto Liquid for use in the template.
+    #
+    # Valid options:
+    #
+    #   layout: If set to a string, an attempt will be made to use that layout.
+    #           If set to false no layout will be used.
+    #           If set to true (the default) the default layout will be used.
+    def render_template(path, locals = {}, options = {})
+      options[:layout] = "layout" if options[:layout] == true || options[:layout].nil?
+      
+      template = Template.from_file(path)
+      body = template.render(locals)
+      
+      if options[:layout]
+        begin
+          body = render_template(theme_path("#{options[:layout]}.html"), { 'body' => body }, :layout => false)
+        rescue Noumenon::Template::NotFoundError => ignore_missing_layouts
+        end
+      end
+      
+      body
+    end
+    
+    # Render a piece of content from the content repository, using the template specified within
+    # the content item.
+    #
+    # If no template was specified then the template "default" will be used.
+    def render_content(path)
+      content = File.read(content_path(path))
+      item = YAML.load( content )
+      
+      [ 200, render_template( theme_path("#{item["template"]}.html"), item ) ]
+    end
+    
+    # Locate a piece of content in the content repository based on the URL it is being accessed from.
+    #
+    # The following files will satisfy a request for "/example", in the order shown:
+    #
+    # 1. "repository/example.yml
+    # 2. "repository/example/index.yml
+    #
+    def locate_content_for(path)
+      if File.exists?(content_path("#{path}.yml"))
+        return "#{path}.yml"
+      else
+        if File.exists?(content_path(path)) && File.exists?(content_path("#{path}/index.yml"))
+          return "#{path}/index.yml"
+        end
+      end
+
+      nil
+    end
+
+    get '*' do |path|
+      path = locate_content_for(path)
+      path ? render_content(path) : [ 404, "Not Found" ]
+    end
+  end
+end

data/lib/noumenon/spec.rb

@@ -0,0 +1,8 @@
+require 'noumenon/spec/fixtures'
+
+module Noumenon
+  # Spec helpers used while testing Noumenon, and Noumenon applications.
+  module Spec
+    include Noumenon::Spec::Fixtures
+  end
+end

data/lib/noumenon/spec/fixtures.rb

@@ -0,0 +1,34 @@
+require 'pathname'
+
+module Noumenon
+  module Spec
+    # Provides a simple way of mocking a content repository for specs.
+    module Fixtures
+      # The current path that fixtures are looked up from.
+      def fixture_path(path = nil)
+        @fixture_path ||= 'spec/fixtures'
+        path.nil? ? @fixture_path : File.join(@fixture_path, path)
+      end
+
+      # Set the path that fixtures will be looked up from.
+      #
+      # Unless set to an absolute path the provided path will be assumed to be a sub-directory
+      # of "spec/fixtures".
+      def fixture_path=(value)
+        value = File.join("spec/fixtures", value) unless Pathname.new(value).absolute?
+        @fixture_path = value
+      end
+
+      # Loads a fixture from the specified path.
+      #
+      # Example:
+      #     
+      #     File.write(File.join(fixture_path, "index.html"), "<h1>Hello, world!</h1>")
+      #     fixture("index.html")
+      #     # => "<h1>Hello, world!</h1>"
+      def fixture(path)
+        File.read File.join(fixture_path, path)
+      end
+    end
+  end
+end

data/lib/noumenon/template.rb

@@ -0,0 +1,88 @@
+require 'liquid'
+
+module Noumenon
+  # Templates specify the structure and presentation of a particular piece of content in
+  # a Noumenon site, and are usually provided by a theme.
+  #
+  # A template is split into two parts, the metadata, which defines what data is needed for
+  # the template, and a Liquid template, which defines how the data should be presented. When
+  # loaded from a file, a template will look like this:
+  #
+  #     title:
+  #       label: Page title
+  #       required: true
+  #       type: string
+  #       help: The title displayed at the top of the page
+  #     author:
+  #       label: Author
+  #       required: false
+  #       type: string
+  #       help: The author of the article. If not provided, no byline will be shown.
+  #     body:
+  #       label: Body text
+  #       required: true
+  #       type: text
+  #       help: The main article body. Will be processed with Textile for formatting.
+  #     ---
+  #     <h1>{{ title }}</h1>
+  #     {% if author %}
+  #       <p class="byline">By {{ author }}</p>
+  #     {% endif %}
+  #     {{ body | textilize }}
+  # 
+  #  And can be rendered like this:
+  #
+  #      Template.from_file("/path/to/template").render("title" => "An Example Page", "author" => "Jon Wood", "body" => "This is an article...")
+  #  
+  #  If any required fields are missing from the data provided then a MissingContentError will be raised.
+  class Template
+    class MissingContentError < StandardError; end
+    class NotFoundError < StandardError; end
+    
+    # The location this template was loaded from.
+    attr_accessor :source
+
+    # The template view.
+    attr_accessor :content
+
+    # The fields used by this template.
+    attr_accessor :fields
+    
+    # Loads a template from the specified path.
+    #
+    # If the file does not exist then a NotFoundError will be raised.
+    def self.from_file(path)
+      raise NotFoundError.new("No template could be found at #{path}.") unless File.exists?(path)
+      
+      content = File.read(path)
+
+      parts = content.split("\n---\n")
+      if parts.size == 1
+        fields = {}
+      else
+        fields = YAML.load(parts.first)
+        content = parts.last
+      end
+
+      self.new(path, content, fields)
+    end
+
+    def initialize(source = nil, content = nil, fields = {})
+      @source = source
+      @content = content
+      @fields = fields
+    end
+    
+    # Renders the template. If any fields are missing from page_content then a MissingContentError will be raised.
+    def render(page_content = {})
+      missing_fields = []
+      fields.each do |key, field|
+        missing_fields << key if field["required"] && !page_content.key?(key)
+      end
+
+      raise MissingContentError.new("The following fields were missing from your content: #{missing_fields.sort.join(", ")}") unless missing_fields.empty?
+
+      Liquid::Template.parse(content).render(page_content)
+    end
+  end
+end

data/lib/noumenon/version.rb

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

data/noumenon.gemspec

@@ -0,0 +1,27 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "noumenon/version"
+
+Gem::Specification.new do |s|
+  s.name        = "noumenon"
+  s.version     = Noumenon::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Jon Wood"]
+  s.email       = ["jon@blankpad.net"]
+  s.homepage    = "https://github.com/Noumenon"
+  s.summary     = %q{An content management system backed by Git}
+  s.description = File.read("README.md")
+
+  s.rubyforge_project = "noumenon"
+
+  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.require_paths = ["lib"]
+  
+  s.add_dependency "sinatra", ">= 1.2.3"
+  s.add_dependency "liquid",  ">= 2.2"
+
+  s.add_development_dependency "rspec",     ">= 2.5.0"
+  s.add_development_dependency "rack-test", ">= 0.5"
+end

data/spec/fixtures/fixture_specs/test

@@ -0,0 +1 @@
+Hello, fixtures.

data/spec/fixtures/static_example/directory_with_index/index.yml

@@ -0,0 +1 @@
+template: "basic_template"

data/spec/fixtures/static_example/found.html

@@ -0,0 +1 @@
+<h1>Hello</h1>

data/spec/fixtures/static_example/liquid_example.html

@@ -0,0 +1 @@
+Hello liquid.

data/spec/fixtures/static_example/template_with_substitutions.html

@@ -0,0 +1 @@
+Hello, {{ name }}

data/spec/fixtures/static_example/templates/basic_example.yml

@@ -0,0 +1 @@
+template: "basic_template"

data/spec/fixtures/static_example/templates/with_fields.yml

@@ -0,0 +1,2 @@
+template: "fields"
+example_field: "value"

data/spec/fixtures/static_example_dependencies/themes/example/assets/example.txt

@@ -0,0 +1 @@
+Hello, world.

data/spec/fixtures/static_example_dependencies/themes/example/layout.html

@@ -0,0 +1,3 @@
+<div id="layout">
+{{ body }}
+</div>

data/spec/fixtures/static_example_dependencies/themes/example_without_layout/basic_template.html

@@ -0,0 +1 @@
+<h1>This is a Basic Template</h1>

data/spec/fixtures/static_example_dependencies/themes/example_without_layout/fields.html

@@ -0,0 +1 @@
+Field: {{ example_field }}

data/spec/fixtures/static_example_dependencies/themes/example_without_layout/template_with_fields.html

@@ -0,0 +1,23 @@
+title:
+  type: string
+  label: Page title
+  help: Appears at the top of the page.
+  required: true
+
+body:
+  type: text
+  label: Body text
+  help: The main body of the page
+  required: true
+
+author:
+  type: string
+  label: Author name
+  help: If not provided no author will be shown
+  required: false
+---
+<h1>{{ title }}</h1>
+<div id="content">{{ body }}</div>
+{% if author %}
+<p class="byline">Written by {{ author }}.</p>
+{% endif %}

data/spec/noumenon/config_spec.rb

@@ -0,0 +1,29 @@
+require 'spec_helper'
+
+describe Noumenon::Configuration do
+  it { should_not be_nil }
+
+  it { should respond_to(:content_repository_path) }
+  it { should respond_to(:content_repository_path=) }
+  
+  it { should respond_to(:dependencies_path) }
+  it { should respond_to(:dependencies_path=) }
+  
+  it { should respond_to(:theme) }
+  it { should respond_to(:theme=) }
+  
+  describe "setting the theme" do
+    before(:each) do
+      subject.dependencies_path = fixture_path("static_example_dependencies")
+    end
+
+    it "succeeds if the theme exists" do
+      subject.theme = "example"
+      subject.theme.should == "example"
+    end
+    
+    it "raises an exception if the theme could not be found" do
+      lambda { subject.theme = "none_existant" }.should raise_error Noumenon::Configuration::ThemeNotFoundError
+    end
+  end
+end

data/spec/noumenon/core_spec.rb

@@ -0,0 +1,105 @@
+require 'spec_helper'
+
+describe Noumenon::Core do
+  def app
+    Noumenon::Core.new
+  end
+  
+  describe "accessing configuration" do
+    it { should respond_to(:config) }
+    it "returns the global configuration when calling config" do
+      app.config.should == Noumenon.config
+    end
+  end
+  
+  describe "retrieving paths" do
+    it { should respond_to(:content_path) }
+
+    it "locate a path in the content repository" do
+      app.content_path("example").should == "#{app.config.content_repository_path}/example"
+    end
+    
+    it { should respond_to(:theme_path) }
+
+    it "can locate a path in the theme directory" do
+      app.theme_path("file").should == "#{app.config.dependencies_path}/themes/example/file"
+    end
+  end
+
+  describe "rendering a template" do
+    it { should respond_to(:render_template) }
+    
+    context "when the theme has no layout" do
+      before(:each) { app.config.theme = "example_without_layout" }
+
+      it "renders the requested template if it does exist" do
+        app.render_template( app.content_path("found.html") ).should == fixture("static_example/found.html")
+      end
+
+      it "uses Liquid to replace any tags in the template" do
+        app.render_template( app.content_path("template_with_substitutions.html"), 'name' => 'Jon' ).should == "Hello, Jon\n"
+      end
+    end
+
+    context "when the theme has a layout" do
+      before(:each) { app.config.theme = "example" }
+
+      it "renders the template within the theme's layout by default" do
+        app.render_template( app.content_path("found.html") ).should == %Q{<div id="layout">\n#{fixture("static_example/found.html")}\n</div>\n}
+      end
+
+      it "ignores the layout if the option :layout => false is passed" do
+        app.render_template( app.content_path("found.html"), {}, :layout => false ).should == fixture("static_example/found.html")
+      end
+    end
+  end
+
+  describe "serving content from the content repository" do
+    before(:each) { app.config.theme = "example_without_layout" }
+    
+    context "when the requested item does not exist" do
+      context "and an index file exists in a directory of the same name" do
+        it "renders the index file instead" do
+          get "/directory_with_index"
+
+          last_response.should be_ok
+          last_response.body.should == File.read(app.theme_path("basic_template.html"))
+        end
+      end
+      
+      context "and no index file exists in a directory of the same name" do
+        it "responds with a status of 404" do
+          get "/empty_directory"
+
+          last_response.should_not be_ok
+          last_response.status.should == 404
+        end
+      end
+
+      context "and no directory of the same name exists" do
+        it "responds with a status of 404" do
+          get "/not_found"
+
+          last_response.should_not be_ok
+          last_response.status.should == 404
+        end
+      end
+    end
+
+    context "when the requested item exists" do
+      it "renders the specified template from the theme" do
+        get "/templates/basic_example"
+
+        last_response.should be_ok
+        last_response.body.should == File.read(app.theme_path("basic_template.html"))
+      end
+      
+      it "makes substitutions as specified in the template" do
+        get "/templates/with_fields"
+
+        last_response.should be_ok
+        last_response.body.should =~ /Field: value/
+      end
+    end
+  end
+end

data/spec/noumenon/spec/fixtures_spec.rb

@@ -0,0 +1,41 @@
+require 'noumenon/spec/fixtures'
+
+class FixturedSpec
+  include Noumenon::Spec::Fixtures
+end
+
+describe "a class with Noumenon::Spec::Fixtures mixed in" do
+  subject { FixturedSpec.new }
+  
+  describe "the fixture path" do
+    it { should respond_to(:fixture_path) }
+    it { should respond_to(:fixture_path=) }
+  
+    it "defaults the fixture path to 'spec/fixtures'" do
+      subject.fixture_path.should == 'spec/fixtures'
+    end
+
+    it "appends the provided path to spec/fixtures if relative" do
+      subject.fixture_path = "test"
+      subject.fixture_path.should == "spec/fixtures/test"
+    end
+
+    it "sets the path provided if absolute" do
+      subject.fixture_path = "/tmp"
+      subject.fixture_path.should == "/tmp"
+    end
+
+    it "returns the full path to the fixture if fixture_path is passed an argument" do
+      subject.fixture_path = "/tmp"
+      subject.fixture_path("example").should == "/tmp/example"
+    end
+  end
+  
+  describe "loading a fixture" do
+    it { should respond_to(:fixture) }
+
+    it "returns the contents of the specified file" do
+      subject.fixture("fixture_specs/test").should eq "Hello, fixtures.\n"
+    end
+  end
+end

data/spec/noumenon/spec_spec.rb

@@ -0,0 +1,7 @@
+require 'noumenon/spec'
+
+describe Noumenon::Spec do
+  it { should_not be_nil }
+
+  it { should include Noumenon::Spec::Fixtures }
+end

data/spec/noumenon/template_spec.rb

@@ -0,0 +1,118 @@
+require 'spec_helper'
+
+describe Noumenon::Template do
+  it { should_not be_nil }
+  
+  def template_path(name)
+    Noumenon::Core.new.theme_path(name)
+  end
+  
+  before(:each) do
+    Noumenon.config.theme = "example_without_layout"
+  end
+  
+  it { should respond_to(:fields) }
+  it { should respond_to(:source) }
+  it { should respond_to(:content) }
+
+  describe "loading a template from disk" do
+    it "raises a TemplateNotFoundError if the template does not exist" do
+      lambda { Noumenon::Template.from_file "dummy" }.should raise_error Noumenon::Template::NotFoundError
+    end
+
+    context "when the template has no fields specified" do
+      subject do
+        Noumenon::Template.from_file template_path("basic_template.html")
+      end
+      
+      it "leaves #fields empty" do
+        subject.fields.should be_empty
+      end
+
+      it "populates #source with the path to the template" do
+        subject.source.should == template_path("basic_template.html")
+      end
+      
+      it "populates #content with the template body" do
+        subject.content.should == File.read(template_path("basic_template.html"))
+      end
+    end
+
+    context "when the template has some fields specified" do
+      subject do
+        Noumenon::Template.from_file template_path("template_with_fields.html")
+      end
+
+      it "populates the field data for the title" do
+        subject.fields["title"].should == {
+          "type" => "string",
+          "label" => "Page title",
+          "help" => "Appears at the top of the page.",
+          "required" => true
+        }
+      end
+
+      it "populates the field data for the body" do
+        subject.fields["body"].should == {
+          "type" => "text",
+          "label" => "Body text",
+          "help" => "The main body of the page",
+          "required" => true
+        }
+      end
+
+      it "populates the field data for the author" do
+        subject.fields["author"].should == {
+          "type" => "string",
+          "label" => "Author name",
+          "help" => "If not provided no author will be shown",
+          "required" => false
+        }
+      end
+
+      it "populates #content with the template body" do
+        subject.content.should eq File.read(template_path("template_with_fields.html")).split("\n---\n").last
+      end
+    end
+  end
+
+  describe "rendering a template" do
+    let(:template) { Noumenon::Template.from_file template_path("template_with_fields.html") }
+    
+    it { should respond_to(:render) }
+
+    context "when missing required fields" do
+      it "raises a Noumenon::Template::MissingContentError" do
+        lambda { template.render }.should raise_error Noumenon::Template::MissingContentError
+      end
+
+      it "lists the missing fields in the exception" do
+        begin
+          template.render
+        rescue Noumenon::Template::MissingContentError => e
+          e.to_s.should eq "The following fields were missing from your content: body, title"
+        end
+      end
+    end
+
+    context "when all required fields were provided" do
+      it "renders the template, replacing any fields" do
+        content = template.render("title" => "Example Page", "body" => "This is an example, isn't it lovely.", "author" => "Jon Wood")
+
+        content.should =~ %r{<h1>Example Page</h1>}
+        content.should =~ %r{<div id="content">This is an example, isn't it lovely.</div>}
+        content.should =~ %r{<p class="byline">Written by Jon Wood.</p>}
+      end
+    end
+
+    context "when provided with fields that are not specified for the template" do
+      it "renders the template anyway" do
+        content = template.render("title" => "Example Page", "body" => "This is an example, isn't it lovely.", "author" => "Jon Wood", "unknown" => "is here")
+
+        content.should =~ %r{<h1>Example Page</h1>}
+        content.should =~ %r{<div id="content">This is an example, isn't it lovely.</div>}
+        content.should =~ %r{<p class="byline">Written by Jon Wood.</p>}
+      end
+    end
+  end
+end

data/spec/noumenon_spec.rb

@@ -0,0 +1,61 @@
+require 'spec_helper'
+
+describe Noumenon do
+  before(:each) do
+    Noumenon.config.dependencies_path = fixture_path("static_example_dependencies")
+  end
+  
+  specify { Noumenon.should respond_to(:boot) }
+  
+  def app
+    Noumenon.boot
+  end
+  
+  describe "serving theme assets" do
+    it "serves the asset specified at /themes/theme_name/example.txt if the file exists" do
+      get '/themes/example/example.txt'
+
+      last_response.status.should == 200
+      last_response.body.should == fixture("static_example_dependencies/themes/example/assets/example.txt")
+    end
+
+    it "returns a status of 404 if the file does not exist" do
+      get '/themes/example/not_found.png'
+
+      last_response.status.should == 404
+    end
+  end
+
+  describe "setting configuration" do
+    before(:each) do
+      Noumenon.config = nil
+    end
+    
+    specify { Noumenon.should respond_to(:configure) }
+    specify { Noumenon.should respond_to(:config) }
+    specify { Noumenon.should respond_to(:config=) }
+
+    it "sets config to the provided object on config=" do
+      config = Noumenon::Configuration.new
+      Noumenon.config = config
+      Noumenon.config.should == config
+    end
+
+    it "returns a new config instance if no config was previously set" do
+      Noumenon.config.should be_instance_of Noumenon::Configuration
+    end
+
+    it "yields the config instance if a block is provided" do
+      yielded = false
+
+      config = Noumenon::Configuration.new
+      Noumenon.config = config
+      Noumenon.configure do |c|
+        c.should == config
+        yielded = true
+      end
+
+      yielded.should be_true
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,19 @@
+require 'noumenon'
+require 'noumenon/spec'
+require 'rack/test'
+
+RSpec.configure do |spec|
+  spec.include Rack::Test::Methods
+  spec.include Noumenon::Spec
+  include Noumenon::Spec::Fixtures
+  
+  Noumenon::Core.set :environment, :test
+  
+  spec.before(:each) do
+    Noumenon.configure do |c|
+      c.content_repository_path = fixture_path("static_example")
+      c.dependencies_path = fixture_path("static_example_dependencies")
+      c.theme = "example"
+    end
+  end
+end

data/watchr.rb

@@ -0,0 +1,2 @@
+watch( 'spec/.*\.rb' ) { |md| system("rake specs") }
+watch( 'lib/.*\.rb') { |md| system("rake specs") }

metadata

@@ -0,0 +1,236 @@
+--- !ruby/object:Gem::Specification 
+name: noumenon
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Jon Wood
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-04-19 00:00:00 +01:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: sinatra
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.2.3
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: liquid
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "2.2"
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 2.5.0
+  type: :development
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: rack-test
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0.5"
+  type: :development
+  version_requirements: *id004
+description: |
+  # Noumenon
+  
+  Noumenon: Noun. The intellectual conception of a thing as it is in itself, not as it is known through perception.
+  
+  ## What is This Thing?
+  
+  Noumenon is a web application based on Sinatra for constructing dynamic websites which use a Git repository
+  for storing all content. It's designed to allow technical and non-technical teams to collaborate on development and
+  populate of a content management system using the tools they are most comfortable with.
+  
+  In the case of developers (and some designers) that's version control and text editors, while in the case of content
+  editors thats more likely to be a web interface.
+  
+  ## How it Works
+  
+  The URL structure and content of a Noumenon site is defined by a Git repository, similar to the structure below:
+  
+      /
+      - /config.rb
+      - /index.html
+      - /about
+        - /people.html
+        - /company.html
+      - /contact
+        - /config.rb
+      - /blog
+        - /config.rb
+        - /posts/2011-04-18-an-example-post.md
+        - /posts/2011-04-10-another-example.md
+  
+  This git repository is then provided to Noumenon as it's data source. On startup it loads any file called "config.rb"
+  and uses it to determine how that directory should behave:
+  
+      # /config.rb
+      domain      "example.org"
+      application "git://github.com/noumenon/apps-static"
+      theme       "git://github.com/noumenon/themes-example"
+  
+  That example configures Noumenon to use the "Noumenon::Static" application to serve any templates below that point as
+  a static page.
+  
+      # /contact/config.rb
+      application           "git://github.com/noumenon/apps-contact"
+      contact.email_address "info@example.org"
+  
+  While the one in /contact specifies that "Noumenon::Contact" should be used to provide the URL tree below /contact, in this
+  case a contact form which emails any responses to the specified address.
+  
+  Finally /blogs/config.rb might look something like this:
+  
+      application   "git://github.com/noumenon/apps-blog"
+      blog.comments true
+  
+  ## Hosting a Noumenon Site
+  
+  *This won't work yet: I havn't implemented automatic check out of a content repository.*
+  
+  To host a site you will need to have Ruby and an application server such as Passenger, Unicorn or Thin. Due it's interactions
+  with git as a data store Heroku is not a supported platform for hosting, although I'm sure someone will find a way around that.
+  
+  Install Noumenon: `gem install noumenon`
+  
+  Create a directory, and put the following config.ru in it:
+  
+      require 'noumenon'
+      Noumenon::Core.set :content_repository, "git@github.com:Noumenon/example.git"
+      
+      run Noumenon.boot
+  
+  And then set up your application server to provide that application. On startup it will first attempt to check out the content
+  repository, then it will parse any configuration files, and install any required dependencies. Finally, it will start hosting
+  the site.
+  
+  To update the content repository restart your application server, which will cause it to update the repository, and any dependencies.
+  
+  ### Hosting on Heroku
+  
+  The someone who worked out the way around it was me it seems. This will only work if you're deploying an entirely static site,
+  if you need the admin section to work then you'll have to host somewhere else, but otherwise, use a config.ru like this, and make
+  sure you have Noumenon in your Gemfile:
+  
+      require 'noumenon'
+      Noumenon::Core.set :content_repository_path, File.expand_path("..", __FILE__)
+      
+      run Noumenon.boot
+
+email: 
+- jon@blankpad.net
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- .travis.yml
+- Gemfile
+- README.md
+- Rakefile
+- lib/noumenon.rb
+- lib/noumenon/configuration.rb
+- lib/noumenon/core.rb
+- lib/noumenon/spec.rb
+- lib/noumenon/spec/fixtures.rb
+- lib/noumenon/template.rb
+- lib/noumenon/version.rb
+- noumenon.gemspec
+- spec/fixtures/fixture_specs/test
+- spec/fixtures/static_example/directory_with_index/index.yml
+- spec/fixtures/static_example/found.html
+- spec/fixtures/static_example/liquid_example.html
+- spec/fixtures/static_example/template_with_substitutions.html
+- spec/fixtures/static_example/templates/basic_example.yml
+- spec/fixtures/static_example/templates/with_fields.yml
+- spec/fixtures/static_example_dependencies/themes/example/assets/example.txt
+- spec/fixtures/static_example_dependencies/themes/example/layout.html
+- spec/fixtures/static_example_dependencies/themes/example_without_layout/basic_template.html
+- spec/fixtures/static_example_dependencies/themes/example_without_layout/fields.html
+- spec/fixtures/static_example_dependencies/themes/example_without_layout/template_with_fields.html
+- spec/noumenon/config_spec.rb
+- spec/noumenon/core_spec.rb
+- spec/noumenon/spec/fixtures_spec.rb
+- spec/noumenon/spec_spec.rb
+- spec/noumenon/template_spec.rb
+- spec/noumenon_spec.rb
+- spec/spec_helper.rb
+- watchr.rb
+has_rdoc: true
+homepage: https://github.com/Noumenon
+licenses: []
+
+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: noumenon
+rubygems_version: 1.6.2
+signing_key: 
+specification_version: 3
+summary: An content management system backed by Git
+test_files: 
+- spec/fixtures/fixture_specs/test
+- spec/fixtures/static_example/directory_with_index/index.yml
+- spec/fixtures/static_example/found.html
+- spec/fixtures/static_example/liquid_example.html
+- spec/fixtures/static_example/template_with_substitutions.html
+- spec/fixtures/static_example/templates/basic_example.yml
+- spec/fixtures/static_example/templates/with_fields.yml
+- spec/fixtures/static_example_dependencies/themes/example/assets/example.txt
+- spec/fixtures/static_example_dependencies/themes/example/layout.html
+- spec/fixtures/static_example_dependencies/themes/example_without_layout/basic_template.html
+- spec/fixtures/static_example_dependencies/themes/example_without_layout/fields.html
+- spec/fixtures/static_example_dependencies/themes/example_without_layout/template_with_fields.html
+- spec/noumenon/config_spec.rb
+- spec/noumenon/core_spec.rb
+- spec/noumenon/spec/fixtures_spec.rb
+- spec/noumenon/spec_spec.rb
+- spec/noumenon/template_spec.rb
+- spec/noumenon_spec.rb
+- spec/spec_helper.rb