ruby_slippers 0.2.0

data/.rvmrc

@@ -0,0 +1,2 @@
+rvm_gemset_create_on_use_flag=1
+rvm use 1.9.2@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,45 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    builder (3.0.0)
+    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
+    maruku (0.6.0)
+      syntax (>= 1.0.0)
+    rack (1.3.0)
+    rake (0.9.2)
+    rdiscount (1.6.8)
+    riot (0.12.4)
+      rr
+    rr (1.0.2)
+    syntax (1.0.0)
+    test-unit (2.3.0)
+    thor (0.14.6)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  builder
+  guard
+  guard-bundler
+  guard-test
+  hpricot
+  jeweler
+  maruku
+  rack
+  rake
+  rdiscount
+  riot

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,122 @@
+README
+======
+
+RubySlippers, the smartest blogging engine in all of Oz!
+--------------------------------------------------------
+
+[website](http://ruby-slippers.heroku.com)
+
+Introduction
+------------
+
+### 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
+    
+    $ git add .
+    $ git commit -m 'updated blog'
+    $ git push heroku
+
+#### On your own server or locally
+
+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**.
+
+I like to use shotgun as it reloads while I work
+
+    $ cd myblog
+    $ bundle
+    $ shotgun
+    
+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:
+
+    #
+    # Add your settings here
+    # set [:setting], [value]
+    # 
+    set :author,      "Dreamr"                              # blog author
+    set :title,       "RubySlippers, the smartest blog engine in all of Oz!"  # site title
+    # set :root,      "index"                                   # page to load on /
+    set :date,        lambda {|now| now.strftime("%m/%d/%Y") }    # date format for articles
+    # set :markdown,  :smart                                    # use markdown + smart-mode
+    # set :disqus,    false                                     # disqus id, or false
+    set :summary,     :max => 300, :delim => /~/                # length of article summary and delimiter
+    # set :ext,       'txt'                                     # file extension for articles
+    # set :cache,      28800                                    # cache duration, in seconds
+    set :tag_separator, ', '                                    # tag separator for articles
+    set :date, lambda {|now| now.strftime("%B #{now.day.ordinal} %Y") }
+    # set this to your local port. I use shotgun, so 9393.
+    set :url, "http://localhost:9393" if ENV['RACK_ENV'] == 'development'
+
+    # to use haml, add the gem to your Gemfile and bundle, then uncomment this
+    # and redo your templates using haml and renamed to html.haml
+    # set :to_html, lambda { |path, page, binding| 
+    #   Haml::Engine.new(File.read("#{path}/#{page}.html.haml"),
+    #   :attr_wrapper => '"',
+    #   :filename => path ).render(binding)
+    # }
+
+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/TODO

@@ -0,0 +1,32 @@
+TODO
+====
+
+Site features
+-------------
+Contact form (email)
+  * reverse captcha
+  * must be free service
+
+
+Blog features
+-----------------------------
+
+* Most popular posts (hits)
+* Most commented posts (comments)
+* Related posts (by tag)
+
+
+
+Full stack test/deployment scheme
+-------------------------------------------
+
+* Engine
+  [*] Unit Tests
+  [*] Integration Tests
+
+* Staged (deployed)
+  [*] Integration Tests
+  [ ] Client Rake Tests
+  
+  
+

data/VERSION

@@ -0,0 +1 @@
+0.2.0

data/lib/ext/ext.rb

@@ -0,0 +1,164 @@
+require 'enumerator'
+
+class Array
+  # Splits or iterates over the array in groups of size +number+,
+  # padding any remaining slots with +fill_with+ unless it is +false+.
+  #
+  #   %w(1 2 3 4 5 6 7).in_groups_of(3) {|group| p group}
+  #   ["1", "2", "3"]
+  #   ["4", "5", "6"]
+  #   ["7", nil, nil]
+  #
+  #   %w(1 2 3).in_groups_of(2, ' ') {|group| p group}
+  #   ["1", "2"]
+  #   ["3", " "]
+  #
+  #   %w(1 2 3).in_groups_of(2, false) {|group| p group}
+  #   ["1", "2"]
+  #   ["3"]
+  def in_groups_of(number, fill_with = nil)
+    if fill_with == false
+      collection = self
+    else
+      # size % number gives how many extra we have;
+      # subtracting from number gives how many to add;
+      # modulo number ensures we don't add group of just fill.
+      padding = (number - size % number) % number
+      collection = dup.concat([fill_with] * padding)
+    end
+
+    if block_given?
+      collection.each_slice(number) { |slice| yield(slice) }
+    else
+      groups = []
+      collection.each_slice(number) { |group| groups << group }
+      groups
+    end
+  end
+
+  # Splits or iterates over the array in +number+ of groups, padding any
+  # remaining slots with +fill_with+ unless it is +false+.
+  #
+  #   %w(1 2 3 4 5 6 7 8 9 10).in_groups(3) {|group| p group}
+  #   ["1", "2", "3", "4"]
+  #   ["5", "6", "7", nil]
+  #   ["8", "9", "10", nil]
+  #
+  #   %w(1 2 3 4 5 6 7).in_groups(3, '&nbsp;') {|group| p group}
+  #   ["1", "2", "3"]
+  #   ["4", "5", "&nbsp;"]
+  #   ["6", "7", "&nbsp;"]
+  #
+  #   %w(1 2 3 4 5 6 7).in_groups(3, false) {|group| p group}
+  #   ["1", "2", "3"]
+  #   ["4", "5"]
+  #   ["6", "7"]
+  def in_groups(number, fill_with = nil)
+    # size / number gives minor group size;
+    # size % number gives how many objects need extra accommodation;
+    # each group hold either division or division + 1 items.
+    division = size / number
+    modulo = size % number
+
+    # create a new array avoiding dup
+    groups = []
+    start = 0
+
+    number.times do |index|
+      length = division + (modulo > 0 && modulo > index ? 1 : 0)
+      padding = fill_with != false &&
+        modulo > 0 && length == division ? 1 : 0
+      groups << slice(start, length).concat([fill_with] * padding)
+      start += length
+    end
+
+    if block_given?
+      groups.each { |g| yield(g) }
+    else
+      groups
+    end
+  end
+
+  # Divides the array into one or more subarrays based on a delimiting +value+
+  # or the result of an optional block.
+  #
+  #   [1, 2, 3, 4, 5].split(3)                # => [[1, 2], [4, 5]]
+  #   (1..10).to_a.split { |i| i % 3 == 0 }   # => [[1, 2], [4, 5], [7, 8], [10]]
+  def split(value = nil)
+    using_block = block_given?
+
+    inject([[]]) do |results, element|
+      if (using_block && yield(element)) || (value == element)
+        results << []
+      else
+        results.last << element
+      end
+
+      results
+    end
+  end
+end
+
+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 Object
+  def blank?
+    self.nil? || self == ""
+  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.rb

@@ -0,0 +1,28 @@
+require 'yaml'
+require 'date'
+require 'erb'
+require 'rack'
+require 'digest'
+require 'open-uri'
+
+if RUBY_PLATFORM =~ /win32/
+  require 'maruku'
+  Markdown = Maruku
+else
+  require 'rdiscount'
+end
+
+require 'builder'
+
+$:.unshift File.dirname(__FILE__)
+
+require 'ext/ext'
+require 'ruby_slippers/app'
+require 'ruby_slippers/site'
+require 'ruby_slippers/engine'
+require 'ruby_slippers/config'
+require 'ruby_slippers/template'
+require 'ruby_slippers/context'
+require 'ruby_slippers/article'
+require 'ruby_slippers/archives'
+require 'ruby_slippers/repo'