ruby-slippers 0.0.1

data/.rvmrc

@@ -0,0 +1,2 @@
+rvm_gemset_create_on_use_flag=1
+rvm gemset use slippers

data/Gemfile

@@ -0,0 +1,16 @@
+source 'http://rubygems.org'
+
+gem 'rake'
+gem 'rack'
+gem 'hpricot'
+gem 'builder'
+gem 'rdiscount'
+gem 'maruku'
+
+group :test, :development do
+  gem 'guard'
+  gem 'guard-bundler'
+  gem 'guard-test'
+  gem 'riot'
+  gem 'jeweler'
+end

data/Gemfile.lock

@@ -0,0 +1,90 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    builder (3.0.0)
+    capybara (1.0.0)
+      mime-types (>= 1.16)
+      nokogiri (>= 1.3.3)
+      rack (>= 1.0.0)
+      rack-test (>= 0.5.4)
+      selenium-webdriver (~> 0.2.0)
+      xpath (~> 0.1.4)
+    childprocess (0.1.9)
+      ffi (~> 1.0.6)
+    cucumber (1.0.0)
+      builder (>= 2.1.2)
+      diff-lcs (>= 1.1.2)
+      gherkin (~> 2.4.1)
+      json (>= 1.4.6)
+      term-ansicolor (>= 1.0.5)
+    diff-lcs (1.1.2)
+    ffi (1.0.9)
+    gherkin (2.4.1)
+      json (>= 1.4.6)
+    git (1.2.5)
+    guard (0.4.2)
+      thor (~> 0.14.6)
+    guard-bundler (0.1.3)
+      bundler (>= 1.0.0)
+      guard (>= 0.2.2)
+    guard-test (0.3.0)
+      guard (>= 0.2.2)
+      test-unit (~> 2.2)
+    hpricot (0.8.4)
+    jeweler (1.6.2)
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      rake
+    json (1.5.3)
+    json_pure (1.5.3)
+    maruku (0.6.0)
+      syntax (>= 1.0.0)
+    mime-types (1.16)
+    nokogiri (1.4.6)
+    rack (1.3.0)
+    rack-test (0.6.0)
+      rack (>= 1.0)
+    rake (0.9.2)
+    rdiscount (1.6.8)
+    riot (0.12.4)
+      rr
+    rr (1.0.2)
+    rspec (2.6.0)
+      rspec-core (~> 2.6.0)
+      rspec-expectations (~> 2.6.0)
+      rspec-mocks (~> 2.6.0)
+    rspec-core (2.6.4)
+    rspec-expectations (2.6.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.6.0)
+    rubyzip (0.9.4)
+    selenium-webdriver (0.2.1)
+      childprocess (>= 0.1.7)
+      ffi (>= 1.0.7)
+      json_pure
+      rubyzip
+    syntax (1.0.0)
+    term-ansicolor (1.0.5)
+    test-unit (2.3.0)
+    thor (0.14.6)
+    xpath (0.1.4)
+      nokogiri (~> 1.3)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  builder
+  capybara
+  cucumber
+  guard
+  guard-bundler
+  guard-test
+  hpricot
+  jeweler
+  maruku
+  rack
+  rake
+  rdiscount
+  riot
+  rspec

data/Guardfile

@@ -0,0 +1,16 @@
+guard 'bundler' do
+  watch('Gemfile')
+  watch('Gemfile.lock')
+end
+
+guard 'test' do
+  watch(%r{^test/fixtures/articles/(.+)\.txt$})
+  watch(%r{^test/fixtures/templates/(.+)$})
+  watch(%r{^test/fixtures/pages/(.+)$})
+  
+  watch(%r{^lib/(.+)\.rb$})       { |m| "test/#{m[1]}_test.rb" }
+  watch(%r{^lib/ruby_slippers/(.+)\.rb$})  { |m| ["test/unit/#{m[1]}_test.rb", "test/integration/#{m[1]}_test.rb"] }
+  watch(%r{^test/integration/.+_test\.rb$})
+  watch(%r{^test/unit/.+_test\.rb$})
+  watch(%r{^test/support/(.+)\.rb$})          { "test" }
+end

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 dreamr
+
+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,114 @@
+RubySlippers, the smartest blogging engine in all of Oz!
+========================================================
+
+[website](http://ruby-slippers.heroku.com)
+
+Introduction
+------------
+
+
+For Developers
+--------------
+
+#### To set up a new blog
+
+    $ git clone git://github.com/dreamr/ruby-slippers.git myblog
+    $ cd myblog
+    $ gem install bundler
+    $ bundle
+    $ rake install
+    $ -> Blog name: My new blog
+    $ Installing your blog to my-new-blog
+    $ Blog installed!
+    
+    
+#### To create an article
+
+    $ rake new
+    $ -> Title: My new blog post!
+    $ Creating and opening my-new-blog-post (opens in your text editor!)
+    $ rake publish (commits, pushes, publishes then opens in your browser!)
+
+
+Philosophy
+----------
+
+RubySlippers is based on [Toto](http://github.com/cloudhead/toto) and aims to achieve their goals as well as our own. Hosting a ruby based free blog shouldn't be hard. We want to take that a step further and say it should be easy. Easy as pie. Easy as my best friend's Mom. Easy as a 1 click installer.
+
+Oh yeah, MRI, bytecode whatever. If it is Ruby, it should run.
+
+How it works
+------------
+
+- Article management is done with a text editor and git
+  * stored as _.txt_ files, with embeded metadata (in yaml format).
+  * processed through a markdown converter (rdiscount) by default.
+  * can have tags
+  * can have images
+  * can be browsed by date, or tags
+  * comments are handled by [disqus](http://disqus.com)
+- built for easy use with _ERB_.
+- built right on top of _Rack_.
+- built to take advantage of _HTTP caching_.
+- built with _heroku_ in mind.
+
+
+RubySlippers comes with a basic default theme for you to mangle. I hope to release more themes shortly and will accept your submitted themes.
+
+Deployment
+==========
+
+#### on heroku
+
+RubySlippers comes with a basic rackup file. To start it up locally do:
+
+    $ cd myblog
+    $ bundle
+    $ shotgun
+    [2011-06-20 17:04:46] INFO  WEBrick::HTTPServer#start: pid=61628 port=9393
+
+#### on your own server
+
+Once you have created the remote git repo, and pushed your changes to it, you can run RubySlippers with any Rack compliant web server, such as **thin**, **mongrel** or **unicorn**.
+
+With thin, you would do something like:
+
+    $ thin start -R config.ru
+
+With unicorn, you can just do:
+
+    $ unicorn
+
+
+### Configuration
+
+You can configure ruby-slippers, by modifying the _config.ru_ file. For example, if you want to set the blog author to 'John Galt',
+you could add `set :author, 'John Galt'` inside the `RubySlippers::Engine::App.new` block. Here are the defaults, to get you started:
+
+    set :author,      ENV['USER']                               # blog author
+    set :title,       Dir.pwd.split('/').last                   # site title
+    set :url,         'http://example.com'                      # site root URL
+    set :prefix,      ''                                        # common path prefix for all pages
+    set :root,        "index"                                   # page to load on /
+    set :date,        lambda {|now| now.strftime("%d/%m/%Y") }  # date format for articles
+    set :markdown,    :smart                                    # use markdown + smart-mode
+    set :disqus,      false                                     # disqus id, or false
+    set :summary,     :max => 150, :delim => /~\n/              # length of article summary and delimiter
+    set :ext,         'txt'                                     # file extension for articles
+    set :cache,       28800                                     # cache site for 8 hours
+
+    set :to_html   do |path, page, ctx|                         # returns an html, from a path & context
+      ERB.new(File.read("#{path}/#{page}.rhtml")).result(ctx)
+    end
+
+    set :error     do |code|                                    # The HTML for your error page
+      "<font style='font-size:300%'>A large house has landed on you. You cannot continue because you are dead. <a href='/'>try again</a> (#{code})</font>"
+    end
+
+Thanks
+------
+
+* To heroku for making this easy as pie.
+* To the developers of [Toto](http://github.com/cloudhead/toto), for making such an awesome minimal blog engine in Ruby.
+
+Copyright (c) 2011 dreamr. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,5 @@
+require 'rubygems'
+require 'rake'
+Dir.glob('lib/tasks/*.rake').each { |file| import file }
+
+task :default => 'test:all'

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/lib/ext/ext.rb

@@ -0,0 +1,57 @@
+class Object
+  def meta_def name, &blk
+    (class << self; self; end).instance_eval do
+      define_method(name, &blk)
+    end
+  end
+end
+
+class String
+  def slugize
+    self.downcase.gsub(/&/, 'and').gsub(/\s+/, '-').gsub(/[^a-z0-9-]/, '')
+  end
+
+  def humanize
+    self.capitalize.gsub(/[-_]+/, ' ')
+  end
+end
+
+class Fixnum
+  def ordinal
+    # 1 => 1st
+    # 2 => 2nd
+    # 3 => 3rd
+    # ...
+    case self % 100
+      when 11..13; "#{self}th"
+    else
+      case self % 10
+        when 1; "#{self}st"
+        when 2; "#{self}nd"
+        when 3; "#{self}rd"
+        else    "#{self}th"
+      end
+    end
+  end
+end
+
+class Date
+  # This check is for people running RubySlippers::Enginewith ActiveSupport, avoid a collision
+  unless respond_to? :iso8601
+    # Return the date as a String formatted according to ISO 8601.
+    def iso8601
+      ::Time.utc(year, month, day, 0, 0, 0, 0).iso8601
+    end
+  end
+end
+
+module Kernel
+  def silence_stream(stream)
+    old_stream = stream.dup
+    stream.reopen(RUBY_PLATFORM =~ /mswin/ ? 'NUL:' : '/dev/null')
+    stream.sync = true
+    yield
+  ensure
+    stream.reopen(old_stream)
+  end
+end

data/lib/ruby_slippers/app.rb

@@ -0,0 +1,41 @@
+module RubySlippers
+  module Engine
+    class App
+      attr_reader :config, :site
+
+      def initialize config = {}, &blk
+        @config = config.is_a?(Config) ? config : Config.new(config)
+        @config.instance_eval(&blk) if block_given?
+        @site = RubySlippers::Engine::Site.new(@config)
+      end
+
+      def call env
+        @request  = Rack::Request.new env
+        @response = Rack::Response.new
+
+        return [400, {}, []] unless @request.get?
+
+        path, mime = @request.path_info.split('.')
+        route = (path || '/').split('/').reject {|i| i.empty? }
+
+        response = @site.go(route, env, *(mime ? mime : []))
+
+        @response.body = [response[:body]]
+        @response['Content-Length'] = response[:body].length.to_s unless response[:body].empty?
+        @response['Content-Type']   = Rack::Mime.mime_type(".#{response[:type]}")
+
+        # Set http cache headers
+        @response['Cache-Control'] = if RubySlippers::Engine.env == 'production'
+          "public, max-age=#{@config[:cache]}"
+        else
+          "no-cache, must-revalidate"
+        end
+
+        @response['ETag'] = %("#{Digest::SHA1.hexdigest(response[:body])}")
+
+        @response.status = response[:status]
+        @response.finish
+      end
+    end
+  end
+end

data/lib/ruby_slippers/archives.rb

@@ -0,0 +1,22 @@
+module RubySlippers
+  module Engine
+    class Archives < Array
+      include Template
+
+      def initialize articles, config
+        self.replace articles
+        @config = config
+      end
+
+      def [] a
+        a.is_a?(Range) ? self.class.new(self.slice(a) || [], @config) : super
+      end
+
+      def to_html
+        super(:archives, @config)
+      end
+      alias :to_s to_html
+      alias :archive archives
+    end
+  end
+end

data/lib/ruby_slippers/article.rb

@@ -0,0 +1,84 @@
+require 'ruby_slippers/template'
+
+module RubySlippers
+  module Engine
+    class Article < Hash
+      include Template
+
+      def initialize obj, config = {}
+        @obj, @config = obj, config
+        self.load if obj.is_a? Hash
+      end
+
+      def load
+        data = if @obj.is_a? String
+          meta, self[:body] = File.read(@obj).split(/\n\n/, 2)
+
+          # use the date from the filename, or else ruby-slippers won't find the article
+          @obj =~ /\/(\d{4}-\d{2}-\d{2})[^\/]*$/
+          ($1 ? {:date => $1} : {}).merge(YAML.load(meta))
+        elsif @obj.is_a? Hash
+          @obj
+        end.inject({}) {|h, (k,v)| h.merge(k.to_sym => v) }
+
+        self.taint
+        self.update data
+        self[:date] = Date.parse(self[:date].gsub('/', '-')) rescue Date.today
+        self
+      end
+
+      def [] key
+        self.load unless self.tainted?
+        super
+      end
+
+      def slug
+        self[:slug] || self[:title].slugize
+      end
+
+      def summary length = nil
+        config = @config[:summary]
+        sum = if self[:body] =~ config[:delim]
+          self[:body].split(config[:delim]).first
+        else
+          self[:body].match(/(.{1,#{length || config[:length] || config[:max]}}.*?)(\n|\Z)/m).to_s
+        end
+        markdown(sum.length == self[:body].length ? sum : sum.strip.sub(/\.\Z/, '&hellip;'))
+      end
+
+      def url
+        "http://#{(@config[:url].sub("http://", '') + self.path).squeeze('/')}"
+      end
+      alias :permalink url
+
+      def body
+        markdown self[:body].sub(@config[:summary][:delim], '') rescue markdown self[:body]
+      end
+
+      def path
+        "/#{@config[:prefix]}#{self[:date].strftime("/%Y/%m/%d/#{slug}/")}".squeeze('/')
+      end
+  
+      def tags
+        return [] unless self[:tags]
+        self[:tags].split(',').collect do |tag|
+          "#{tag.strip.humanize.downcase}"
+        end.join(@config[:tag_separator])
+      end
+  
+      def tag_links
+        return [] unless self[:tags]
+        self[:tags].split(',').collect do |tag|
+          "<a href=\"/tagged/#{tag.strip.slugize}\">#{tag.strip.humanize.downcase}</a>"
+        end.join(@config[:tag_separator])
+      end
+  
+      def title()     self[:title] || "an article"                end
+      def date()      @config[:date].call(self[:date])            end
+      def author()    self[:author] || @config[:author]           end
+      def image_src() self[:image]                                end
+      def to_html()   self.load; super(:article, @config)         end
+      alias :to_s to_html
+    end
+  end
+end

data/lib/ruby_slippers/config.rb

@@ -0,0 +1,35 @@
+class RubySlippers::Engine::Config < Hash
+  Defaults = {
+    :author => ENV['USER'],                               # blog author
+    :title => Dir.pwd.split('/').last,                    # site title
+    :root => "index",                                     # site index
+    :url => "http://127.0.0.1",                           # root URL of the site
+    :prefix => "",                                        # common path prefix for the blog
+    :date => lambda {|now| now.strftime("%d/%m/%Y") },    # date function
+    :markdown => :smart,                                  # use markdown
+    :disqus => false,                                     # disqus name
+    :summary => {:max => 150, :delim => /~\n/},           # length of summary and delimiter
+    :ext => 'txt',                                        # extension for articles
+    :cache => 28800,                                      # cache duration (seconds)
+    :tag_separator => ', ',                               # tag separator for articles
+    :github => {:user => "dreamr", :repos => [], :ext => 'md'}, # Github username and list of repos
+    :to_html => lambda {|path, page, ctx|                 # returns an html, from a path & context
+      ERB.new(File.read("#{path}/#{page}.rhtml")).result(ctx)
+    },
+    :error => lambda {|code|                              # The HTML for your error page
+      "<font style='font-size:300%'>A large house has landed on you. You cannot continue because you are dead. <a href='/'>try again</a> (#{code})</font>"
+    }
+  }
+  def initialize obj
+    self.update Defaults
+    self.update obj
+  end
+
+  def set key, val = nil, &blk
+    if val.is_a? Hash
+      self[key].update val
+    else
+      self[key] = block_given?? blk : val
+    end
+  end
+end

data/lib/ruby_slippers/context.rb

@@ -0,0 +1,38 @@
+module RubySlippers
+  module Engine
+    class Context
+      include Template
+      attr_reader :env
+
+      def initialize ctx = {}, config = {}, path = "/", env = {}
+        @config, @context, @path, @env = config, ctx, path, env
+        @articles = Site.articles(@config[:ext]).reverse.map do |a|
+          Article.new(a, @config)
+        end
+
+        ctx.each do |k, v|
+          meta_def(k) { ctx.instance_of?(Hash) ? v : ctx.send(k) }
+        end
+      end
+  
+      def title
+        @config[:title]
+      end
+
+      def render page, type
+        content = to_html page, @config
+        type == :html ? to_html(:layout, @config, &Proc.new { content }) : send(:"to_#{type}", page)
+      end
+
+      def to_xml page
+        xml = Builder::XmlMarkup.new(:indent => 2)
+        instance_eval File.read("#{Paths[:templates]}/#{page}.builder")
+      end
+      alias :to_atom to_xml
+
+      def method_missing m, *args, &blk
+        @context.respond_to?(m) ? @context.send(m, *args, &blk) : super
+      end
+    end
+  end
+end

data/lib/ruby_slippers/engine.rb

@@ -0,0 +1,21 @@
+module RubySlippers
+  module Engine
+    Paths = {
+      :templates  => "templates",
+      :pages      => "templates/pages",
+      :articles   => "articles"
+    } unless defined?(Paths)
+
+    def self.gem_root
+      File.expand_path("../../", __FILE__)
+    end
+
+    def self.env
+      ENV['RACK_ENV'] || 'production'
+    end
+
+    def self.env= env
+      ENV['RACK_ENV'] = env
+    end
+  end
+end

data/lib/ruby_slippers/repo.rb

@@ -0,0 +1,21 @@
+module RubySlippers
+  module Engine
+    class Repo < Hash
+      include Template
+
+      README = "https://github.com/%s/%s/raw/master/README.%s"
+
+      def initialize name, config
+        self[:name], @config = name, config
+      end
+
+      def readme
+        markdown open(README %
+          [@config[:github][:user], self[:name], @config[:github][:ext]]).read
+      rescue Timeout::Error, OpenURI::HTTPError => e
+        "This page isn't available."
+      end
+      alias :content readme
+    end
+  end
+end