rango 0.1.pre → 0.1.0

data/CHANGELOG

@@ -14,9 +14,12 @@
 = Version 0.1
   * [FEATURE] environments support
   * [FEATURE] installation without RubyGems
-  * [FEATURE] Rip support
   * [FEATURE] HTTP caching
   * [FEATURE] Hooks for Rendering
   * [SPECS]   Integration with RunCodeRun.com
   * [SPECS]   All specs passing
 	* SimpleTemplater, RubyExts & CLI
+  * [FEATURE] Bundler Support
+  * [FEATURE] Generic view
+  * [FEATURE] Project generator
+  * [FEATURE] Rack-mount support

data/README.textile

@@ -1,7 +1,14 @@
-h1. Installation
+h1. Installation via RubyGems
 
-* From RubyForge: @sudo gem install rango --development@
-* From Gemcutter: @sudo gem install rango -s http://gemcutter.org --development@
+* Daily builds: @gem install rango --pre@ _(Daily builds currently doesn't work, I'm going to fix it till end of this week.)_
+* Stable version: @gem install rango@
+
+_We were using option @--development@ for installing development dependencies, unfortunately Rack has Mongrel as a development dependency and Mongrel compilation fails on Ruby 1.9, so I put everything into normal dependencies for now._
+
+h1. Installation via "Rip":http://hellorip.com
+
+* Install edge version: @rip install git://github.com/botanicus/rango.git@
+* Install tagged version: @rip install git://github.com/botanicus/rango.git 0.1@
 
 h1. Documentation
 
@@ -9,9 +16,10 @@ h1. Documentation
 * "Tutorial":http://wiki.github.com/botanicus/rango/tutorial
 * "API Docs":http://rdoc.info/projects/botanicus/rango
 * "Examples":http://github.com/botanicus/rango-examples
-* "Rango Development":http://wiki.github.com/botanicus/rango/rango-development
 * "Bug reporting":http://github.com/botanicus/rango/issues
 
 h1. Community
 
+* "Rango Blog":http://botanicus.github.com/rango
 * "Twitter":https://twitter.com/RangoProject
+* IRC: #rango at irc://irc.freenode.net

data/examples/README.textile

@@ -1,13 +1,12 @@
 h1. About
 
-These small applications are examples of usage Rango web framework
+Just example application for "Rango":http://github.com/botanicus/rango framework.
 
-h1. Content
+h1. Usage
 
-h2. Flat applications
+Just initialize the git submodules:
 
-In this directory you can find different low-level Rango applications. This type of applications is proper for writing small webservices. If you need something bigger, real web application, take a look at the Twitter application.
-
-h2. Twitter
-
-This is simple, but working example of web application created in Rango. It has warden-powered authentication, AJAX, MVC ...
+<pre>
+git submodule init
+git submodule update
+</pre>

data/{stubs/project/content → examples/blog}/Gemfile

@@ -8,22 +8,44 @@
 # http://yehudakatz.com/2009/11/03/using-the-new-gem-bundler-today
 # http://www.engineyard.com/blog/2009/using-the-rubygems-bundler-for-your-app
 
+# === Shared Gems === #
 # Specify a dependency on rango. When the bundler downloads gems,
 # it will download rango as well as all of rango' dependencies
 gem "rango"#, git: "git://github.com/botanicus/rango.git"
-gem "usher"#, git: "git://github.com/joshbuddy/usher.git"
 gem "rack"#, git: "git://github.com/rack/rack.git"
+
+# router
+gem "usher"#, git: "git://github.com/joshbuddy/usher.git"
+
+# template engine
 gem "haml"#, git: "git://github.com/nex3/haml.git"
 
-gem "dm_sqlite3"#, git: "git://github.com/datamapper/do.git"
+# ORM
 gem "dm-core"#, git: "git://github.com/datamapper/dm-core.git"
 gem "dm-timestamps"#, git: "git://github.com/datamapper/dm-more.git"
+gem "dm-aggregates"#, git: "git://github.com/datamapper/dm-more.git"
+
+# TODO: don't load them
+#gem "thin"#, git: "git://github.com/macournoyer/thin.git" # there seems to be some problems with latest thin
+#gem "unicorn"#, git: "git://repo.or.cz/unicorn.git"
+gem "racksh", require_as: nil#, git: "git://github.com/sickill/racksh.git"
 
-#gem "sequel"#, git: "git://github.com/jeremyevans/sequel.git"
+# === Environment-Specific Setup === #
+only(:development) do
+  gem "shotgun", require_as: nil#, git: "git://github.com/rtomayko/shotgun.git"
+end
+
+except(:stage, :production) do
+  gem "do_sqlite3"#, git: "git://github.com/datamapper/do.git"
+end
+
+only(:stage, :production) do
+  gem "do_mysql"#, git: "git://github.com/datamapper/do.git"
+end
 
 only(:test) do
   gem "rspec"#, git: "git://github.com/dchelimsky/rspec.git"
-  gem "rack-test"#, git: "git://github.com/brynary/rack-test.git"
+  gem "rack-test", require_as: "rack/test"#, git: "git://github.com/brynary/rack-test.git"
   gem "webrat"#, git: "git://github.com/brynary/webrat.git"
 end
 
@@ -34,6 +56,7 @@ only(:cucumber) do
   gem "cucumber"#, git: "git://github.com/aslakhellesoy/cucumber.git"
 end
 
+# === Bundler Setup === #
 # Specify where the bundled gems should be stashed. This directory will
 # be a gem repository where all gems are downloaded to and installed to.
 #

data/examples/blog/Rakefile

@@ -0,0 +1,12 @@
+# encoding: utf-8
+
+require_relative "gems/environment.rb"
+
+desc "Boot environment"
+task :environment do
+  require_relative "init.rb"
+end
+
+#load "pupu/tasks/pupu.rake"
+load "rango/tasks/spec.rake"
+load "rango/orm/tasks/datamapper.rake"

data/examples/blog/bin/autospec

@@ -0,0 +1,3 @@
+#!/Users/botanicus/.rvm/ruby-1.9.1-p243/bin/ruby
+require File.join(File.dirname(__FILE__), "../gems/environment")
+load File.join(File.dirname(__FILE__), "../gems/gems/rspec-1.2.9/bin/autospec")

data/examples/blog/bin/css2sass

@@ -0,0 +1,3 @@
+#!/Users/botanicus/.rvm/ruby-1.9.1-p243/bin/ruby
+require File.join(File.dirname(__FILE__), "../gems/environment")
+load File.join(File.dirname(__FILE__), "../gems/gems/haml-2.2.14/bin/css2sass")

data/examples/blog/bin/cucumber

@@ -0,0 +1,3 @@
+#!/Users/botanicus/.rvm/ruby-1.9.1-p243/bin/ruby
+require File.join(File.dirname(__FILE__), "../gems/environment")
+load File.join(File.dirname(__FILE__), "../gems/gems/cucumber-0.4.4/bin/cucumber")

data/examples/blog/bin/haml

@@ -0,0 +1,3 @@
+#!/Users/botanicus/.rvm/ruby-1.9.1-p243/bin/ruby
+require File.join(File.dirname(__FILE__), "../gems/environment")
+load File.join(File.dirname(__FILE__), "../gems/gems/haml-2.2.14/bin/haml")

data/examples/blog/bin/html2haml

@@ -0,0 +1,3 @@
+#!/Users/botanicus/.rvm/ruby-1.9.1-p243/bin/ruby
+require File.join(File.dirname(__FILE__), "../gems/environment")
+load File.join(File.dirname(__FILE__), "../gems/gems/haml-2.2.14/bin/html2haml")

data/examples/blog/bin/htmldiff

@@ -0,0 +1,3 @@
+#!/Users/botanicus/.rvm/ruby-1.9.1-p243/bin/ruby
+require File.join(File.dirname(__FILE__), "../gems/environment")
+load File.join(File.dirname(__FILE__), "../gems/gems/diff-lcs-1.1.2/bin/htmldiff")

data/examples/blog/bin/launchy

@@ -0,0 +1,3 @@
+#!/Users/botanicus/.rvm/ruby-1.9.1-p243/bin/ruby
+require File.join(File.dirname(__FILE__), "../gems/environment")
+load File.join(File.dirname(__FILE__), "../gems/gems/launchy-0.3.3/bin/launchy")

data/examples/blog/bin/ldiff

@@ -0,0 +1,3 @@
+#!/Users/botanicus/.rvm/ruby-1.9.1-p243/bin/ruby
+require File.join(File.dirname(__FILE__), "../gems/environment")
+load File.join(File.dirname(__FILE__), "../gems/gems/diff-lcs-1.1.2/bin/ldiff")

data/examples/blog/bin/nokogiri

@@ -0,0 +1,3 @@
+#!/Users/botanicus/.rvm/ruby-1.9.1-p243/bin/ruby
+require File.join(File.dirname(__FILE__), "../gems/environment")
+load File.join(File.dirname(__FILE__), "../gems/gems/nokogiri-1.4.0/bin/nokogiri")

data/examples/blog/bin/racksh

@@ -0,0 +1,3 @@
+#!/Users/botanicus/.rvm/ruby-1.9.1-p243/bin/ruby
+require File.join(File.dirname(__FILE__), "../gems/environment")
+load File.join(File.dirname(__FILE__), "../gems/gems/racksh-0.9.4.2/bin/racksh")

data/examples/blog/bin/rackup

@@ -0,0 +1,3 @@
+#!/Users/botanicus/.rvm/ruby-1.9.1-p243/bin/ruby
+require File.join(File.dirname(__FILE__), "../gems/environment")
+load File.join(File.dirname(__FILE__), "../gems/gems/rack-1.0.1/bin/rackup")

data/examples/blog/bin/rake

@@ -0,0 +1,3 @@
+#!/Users/botanicus/.rvm/ruby-1.9.1-p243/bin/ruby
+require File.join(File.dirname(__FILE__), "../gems/environment")
+load File.join(File.dirname(__FILE__), "../gems/gems/rake-0.8.7/bin/rake")

data/examples/blog/bin/rango

@@ -0,0 +1,3 @@
+#!/Users/botanicus/.rvm/ruby-1.9.1-p243/bin/ruby
+require File.join(File.dirname(__FILE__), "../gems/environment")
+load File.join(File.dirname(__FILE__), "../gems/gems/rango-0.1.0/bin/rango")

data/examples/blog/bin/sass

@@ -0,0 +1,3 @@
+#!/Users/botanicus/.rvm/ruby-1.9.1-p243/bin/ruby
+require File.join(File.dirname(__FILE__), "../gems/environment")
+load File.join(File.dirname(__FILE__), "../gems/gems/haml-2.2.14/bin/sass")

data/examples/blog/bin/shotgun

@@ -0,0 +1,3 @@
+#!/Users/botanicus/.rvm/ruby-1.9.1-p243/bin/ruby
+require File.join(File.dirname(__FILE__), "../gems/environment")
+load File.join(File.dirname(__FILE__), "../gems/gems/shotgun-0.4/bin/shotgun")

data/examples/blog/bin/simple-templater

@@ -0,0 +1,3 @@
+#!/Users/botanicus/.rvm/ruby-1.9.1-p243/bin/ruby
+require File.join(File.dirname(__FILE__), "../gems/environment")
+load File.join(File.dirname(__FILE__), "../gems/gems/simple-templater-0.0.1/bin/simple-templater")

data/examples/blog/bin/spec

@@ -0,0 +1,3 @@
+#!/Users/botanicus/.rvm/ruby-1.9.1-p243/bin/ruby
+require File.join(File.dirname(__FILE__), "../gems/environment")
+load File.join(File.dirname(__FILE__), "../gems/gems/rspec-1.2.9/bin/spec")

data/examples/blog/bin/tt

@@ -0,0 +1,3 @@
+#!/Users/botanicus/.rvm/ruby-1.9.1-p243/bin/ruby
+require File.join(File.dirname(__FILE__), "../gems/environment")
+load File.join(File.dirname(__FILE__), "../gems/gems/treetop-1.4.2/bin/tt")

data/examples/blog/blog/init.rb

@@ -0,0 +1,9 @@
+# encoding: utf-8
+
+module Blog
+  extend Rango::ImportMixin
+  extend Rango::ApplicationMixin
+end
+
+require_relative "models.rb"
+require_relative "views.rb"

data/examples/blog/blog/models.rb

@@ -0,0 +1,21 @@
+# encoding: utf-8
+
+module Blog
+  class Post
+    include DataMapper::Resource
+    property :title, String
+    property :slug,  String, key: true
+  end
+
+  class Tag
+    include DataMapper::Resource
+    property :title, String
+    property :slug,  String, key: true
+  end
+
+  class Comment
+    include DataMapper::Resource
+    property :id, Serial
+    property :title, String
+  end
+end

data/examples/blog/blog/views.rb

@@ -0,0 +1,16 @@
+# encoding: utf-8
+
+require "rango/controller"
+
+module Blog
+  class Application < Rango::Controller
+    # TODO: implement application controller
+  end
+
+  class Posts < Application
+    def index
+      @posts = Post.all
+      render "index.html"
+    end
+  end
+end

data/examples/blog/config.ru

@@ -0,0 +1,19 @@
+#!/usr/bin/env ./init.rb -p 4000 -s webrick
+# encoding: utf-8
+
+# Load init.rb even if config.ru is just loaded 
+# This comes handy in Passenger etc, but it's still
+# useful to have config.ru as an executable, because
+# it's easy to have default arguments for bin/rackup
+require_relative "init.rb" unless $0.eql?(__FILE__)
+
+Rango::Router.use(:usher)
+
+# http://github.com/joshbuddy/usher
+Project.router = Usher::Interface.for(:rack) do
+  get("/").to(Blog::Posts.dispatcher(:index)).name(:posts)
+  get("/:slug").to(Blog::Posts.dispatcher(:show)).name(:post)
+end
+
+use Rango::Middlewares::Basic
+run Project.router

data/examples/blog/init.rb

@@ -0,0 +1,49 @@
+#!/usr/bin/env ruby1.9 --disable-gems
+# encoding: utf-8
+
+# This file should set Rango environment
+# You can run your scripts with ./init.rb my-script.rb
+# See http://wiki.github.com/botanicus/rango/rango-boot-process
+
+# bundler
+begin
+  require_relative "gems/environment.rb"
+rescue LoadError => exception
+  abort "LoadError during loading gems/environment: #{exception.message}\nRun gem bundle to fix it."
+end
+
+# settings
+require_relative "settings"
+require_relative "settings_local"
+
+require "rango"
+
+environment = ENV["RANGO_ENV"] || (RANGO_ENV if defined?(RANGO_ENV)) || "development"
+Rango.boot(environment: environment)
+
+Rango.logger.info("Loading dependencies for #{Rango.environment}")
+Bundler.require_env(Rango.environment)
+
+# register applications
+require_relative "blog/init.rb"
+
+# database connection
+DataMapper.setup(:default, "sqlite3:#{Rango.environment}.db")
+
+# if you will run this script with -i argument, interactive session will begin
+Rango.interactive if ARGV.delete("-i")
+
+# so it can work as a runner
+# ./init.rb: start webserver
+if ARGV.length > 0 && $0.eql?(__FILE__)
+  # config.ru
+  if ARGV.last.split(".").last.eql?("ru")
+    if Rango.development?
+      load_relative "bin/shotgun"
+    else
+      load_relative "bin/rackup"
+    end
+  else
+    load ARGV.shift
+  end
+end

data/examples/blog/settings.rb

@@ -0,0 +1,15 @@
+# encoding: utf-8
+
+require "rango/project"
+
+Project.configure do
+  # write it: self.feature = value
+  # read it:  Project.settings.feature
+  self.testing_engine = :rspec
+  self.template_engine = :haml
+  self.orm = :datamapper
+end
+
+# plugins configuration
+# Rango::Plugins::Mailer.configure do
+# end

data/examples/blog/spec/blog/init_spec.rb

@@ -0,0 +1,7 @@
+# encoding: utf-8
+
+require_relative "../spec_helper.rb"
+
+describe Blog do
+  # TODO: write specs
+end

data/examples/blog/spec/blog/models_spec.rb

@@ -0,0 +1,28 @@
+# encoding: utf-8
+
+require_relative "../spec_helper.rb"
+
+describe Blog do
+  include Blog
+  describe Post do
+    before(:each) do
+      @post = Post.new
+    end
+
+    it "should have a title" do
+      @post.should respond_to(:title)
+    end
+
+    it "should have a slug" do
+      @post.should respond_to(:slug)
+    end
+  end
+
+  describe Tag do
+    # TODO: write specs
+  end
+
+  describe Comment do
+    # TODO: write specs
+  end
+end