rango 0.0.3 → 0.0.4

data/doc/head/all-namespaces.html

@@ -18,23 +18,25 @@
       
         <li><a href="AttributeMixin.html" title="AttributeMixin">AttributeMixin</a> <em>(module)</em></li>
       
-        <li><a href="Class.html" title="Class">Class</a> <em>(class)</em></li>
-      
         <li><a href="ColoredString.html" title="ColoredString">ColoredString</a> <em>(class)</em></li>
       
+        <li><a href="Enumerable.html" title="Enumerable">Enumerable</a> <em>(module)</em></li>
+      
+        <li><a href="File.html" title="File">File</a> <em>(class)</em></li>
+      
         <li><a href="Hash.html" title="Hash">Hash</a> <em>(class)</em></li>
       
         <li><a href="Kernel.html" title="Kernel">Kernel</a> <em>(module)</em></li>
       
+        <li><a href="OS.html" title="OS">OS</a> <em>(class)</em></li>
+      
         <li><a href="Object.html" title="Object">Object</a> <em>(class)</em></li>
       
         <li><a href="ObjectSpace.html" title="ObjectSpace">ObjectSpace</a> <em>(module)</em></li>
       
-        <li><a href="Path.html" title="Path">Path</a> <em>(class)</em></li>
-      
         <li><a href="Range.html" title="Range">Range</a> <em>(class)</em></li>
       
-        <li><a href="Rango.html" title="Rango">Rango</a> <em>(class)</em></li>
+        <li><a href="Rango.html" title="Rango">Rango</a> <em>(module)</em></li>
       
         <li><a href="Rango/ApplicationMixin.html" title="Rango::ApplicationMixin">Rango::ApplicationMixin</a> <em>(module)</em></li>
       
@@ -44,22 +46,20 @@
       
         <li><a href="Rango/Bundling/Strategy.html" title="Rango::Bundling::Strategy">Rango::Bundling::Strategy</a> <em>(class)</em></li>
       
+        <li><a href="Rango/CLI.html" title="Rango::CLI">Rango::CLI</a> <em>(module)</em></li>
+      
+        <li><a href="Rango/CLI/Generator.html" title="Rango::CLI::Generator">Rango::CLI::Generator</a> <em>(class)</em></li>
+      
+        <li><a href="Rango/CLI/Templater.html" title="Rango::CLI::Templater">Rango::CLI::Templater</a> <em>(class)</em></li>
+      
         <li><a href="Rango/Chainable.html" title="Rango::Chainable">Rango::Chainable</a> <em>(module)</em></li>
       
         <li><a href="Rango/Configurable.html" title="Rango::Configurable">Rango::Configurable</a> <em>(module)</em></li>
       
-        <li><a href="Rango/Controller.html" title="Rango::Controller">Rango::Controller</a> <em>(class)</em></li>
-      
         <li><a href="Rango/ControllerMixin.html" title="Rango::ControllerMixin">Rango::ControllerMixin</a> <em>(module)</em></li>
       
-        <li><a href="Rango/Dispatcher.html" title="Rango::Dispatcher">Rango::Dispatcher</a> <em>(class)</em></li>
-      
         <li><a href="Rango/Form.html" title="Rango::Form">Rango::Form</a> <em>(class)</em></li>
       
-        <li><a href="Rango/Generator.html" title="Rango::Generator">Rango::Generator</a> <em>(class)</em></li>
-      
-        <li><a href="Rango/GenericViews.html" title="Rango::GenericViews">Rango::GenericViews</a> <em>(class)</em></li>
-      
         <li><a href="Rango/Helpers.html" title="Rango::Helpers">Rango::Helpers</a> <em>(module)</em></li>
       
         <li><a href="Rango/Hookable.html" title="Rango::Hookable">Rango::Hookable</a> <em>(module)</em></li>
@@ -68,18 +68,14 @@
       
         <li><a href="Rango/Logger.html" title="Rango::Logger">Rango::Logger</a> <em>(class)</em></li>
       
-        <li><a href="Rango/ModelForm.html" title="Rango::ModelForm">Rango::ModelForm</a> <em>(class)</em></li>
+        <li><a href="Rango/Mini.html" title="Rango::Mini">Rango::Mini</a> <em>(module)</em></li>
       
-        <li><a href="Rango/Project.html" title="Rango::Project">Rango::Project</a> <em>(class)</em></li>
+        <li><a href="Rango/ModelForm.html" title="Rango::ModelForm">Rango::ModelForm</a> <em>(class)</em></li>
       
-        <li><a href="Rango/RenderMixin.html" title="Rango::RenderMixin">Rango::RenderMixin</a> <em>(module)</em></li>
+        <li><a href="Rango/Platform.html" title="Rango::Platform">Rango::Platform</a> <em>(class)</em></li>
       
         <li><a href="Rango/Request.html" title="Rango::Request">Rango::Request</a> <em>(class)</em></li>
       
-        <li><a href="Rango/Router.html" title="Rango::Router">Rango::Router</a> <em>(class)</em></li>
-      
-        <li><a href="Rango/Router/Dispatcher.html" title="Rango::Router::Dispatcher">Rango::Router::Dispatcher</a> <em>(module)</em></li>
-      
         <li><a href="Rango/Session.html" title="Rango::Session">Rango::Session</a> <em>(module)</em></li>
       
         <li><a href="Rango/Settings.html" title="Rango::Settings">Rango::Settings</a> <em>(module)</em></li>
@@ -90,7 +86,7 @@
       
         <li><a href="Rango/Settings/Haml.html" title="Rango::Settings::Haml">Rango::Settings::Haml</a> <em>(class)</em></li>
       
-        <li><a href="Rango/SimpleTemplate.html" title="Rango::SimpleTemplate">Rango::SimpleTemplate</a> <em>(class)</em></li>
+        <li><a href="Rango/Settings/Template.html" title="Rango::Settings::Template">Rango::Settings::Template</a> <em>(class)</em></li>
       
         <li><a href="Rango/StrategyMixin.html" title="Rango::StrategyMixin">Rango::StrategyMixin</a> <em>(module)</em></li>
       
@@ -104,8 +100,12 @@
       
         <li><a href="Rango/Templates/TemplateHelpers.html" title="Rango::Templates::TemplateHelpers">Rango::Templates::TemplateHelpers</a> <em>(module)</em></li>
       
+        <li><a href="Rango/UniqueArray.html" title="Rango::UniqueArray">Rango::UniqueArray</a> <em>(class)</em></li>
+      
         <li><a href="String.html" title="String">String</a> <em>(class)</em></li>
       
+        <li><a href="Time.html" title="Time">Time</a> <em>(class)</em></li>
+      
         <li><a href="TimeDSL.html" title="TimeDSL">TimeDSL</a> <em>(module)</em></li>
       
       </ul>

data/doc/head/readme.html

@@ -12,22 +12,24 @@
     <div id="content">
       <div class="section docstring readme">
         <h1>Installation</h1>
-<p><code>sudo gem install botanicus-rango -s http://gems.github.com</code></p>
+<ul>
+	<li>From RubyForge: <code>sudo gem install rango</code></li>
+	<li>From GitHub: <code>sudo gem install botanicus-rango -s http://gems.github.com</code></li>
+</ul>
 <h1>Documentation</h1>
-<ol>
-	<li><a href="http://rango-project.org/docs/tutorial">Tutorial</a></li>
-	<li><a href="http://api.rango-project.org"><span class="caps">API</span> Docs</a></li>
+<ul>
+	<li><a href="http://wiki.github.com/botanicus/rango">Wiki</a></li>
+	<li><a href="http://wiki.github.com/botanicus/rango/tutorial">Tutorial</a></li>
+	<li><a href="http://rdoc.info/projects/botanicus/rango"><span class="caps">API</span> Docs</a></li>
 	<li><a href="http://github.com/botanicus/rango-examples">Examples</a></li>
-</ol>
-<h1>Rango Development</h1>
-<ol>
-	<li><a href="http://bit.ly/1xIq67">Roadmap</a></li>
-</ol>
+	<li><a href="http://wiki.github.com/botanicus/rango/rango-development">Rango Development</a></li>
+	<li><a href="http://github.com/botanicus/rango/issues">Bug reporting</a></li>
+</ul>
 <h1>Community</h1>
-<ol>
-	<li><a href="rango@conf.netlab.cz">Jabber <span class="caps">MUC</span></a></li>
+<ul>
+	<li><a href="xmpp://rango@conf.netlab.cz">Jabber <span class="caps">MUC</span></a></li>
 	<li><a href="https://twitter.com/RangoProject">Twitter</a></li>
-</ol>
+</ul>
       </div>
     </div>
   </body>

data/examples/README.textile

@@ -0,0 +1,13 @@
+h1. About
+
+These small applications are examples of usage Rango web framework
+
+h1. Content
+
+h2. Flat applications
+
+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 ...

data/examples/flat/basic.ru

@@ -0,0 +1,31 @@
+#!/usr/bin/env rackup -p 4000 -s thin
+# encoding: utf-8
+
+require "rango"
+require "rango/mixins/mini"
+
+Rango.boot
+Rango::Router.use(:urlmap)
+
+# 1) Basic Rack way how to return response
+map("/about/version/1") do
+  # setup Content-Length and Content-Type headers
+  # (both these middlewares are included in Rango::Dispatcher),
+  # so you can also do use Rango::Middlewares::Basic
+  # use Rack::ContentLength
+  # use Rack::ContentType
+  use Rango::Middlewares::Basic
+  run lambda { |env| [200, Hash.new, "Rango version: #{Rango::VERSION}"] }
+end
+
+# 2) Rack way how to return response via Rack API
+# You can use Response#status= and Rack#[]= if you need to setup status resp. headers
+# http://rack.rubyforge.org/doc/classes/Rack/Response.html
+map("/about/version/2") do
+  run lambda { |env| Response.new("Rango version: #{Rango::VERSION}").finish }
+end
+
+# 3) Rango-specific way
+map("/about/version/3") do
+  run app { |request, response| "Rango version: #{Rango::VERSION}" }
+end

data/examples/flat/generic_views.ru

@@ -0,0 +1,16 @@
+#!/usr/bin/env rackup -p 4000 -s thin
+# encoding: utf-8
+
+require "rango"
+require "rango/mixins/mini"
+require "rango/generic_views"
+
+Rango.boot
+
+# rack-router
+Rango::Router.use(:rack_router)
+use Rango::Middlewares::Basic
+
+use Rack::Router do |router|
+  router.map "/about/:template", to: Rango::GenericViews.static
+end

data/examples/flat/info.ru

@@ -0,0 +1,18 @@
+#!/usr/bin/env rackup -p 4000 -s thin
+# encoding: utf-8
+
+require "rango"
+require "rango/mixins/mini"
+
+Rango.boot
+
+use Rango::Middlewares::Basic
+
+map("/") do
+  run app { |request, response|
+    path_regexp  = Regexp.new(Regexp.quote(Rango.path.parent.to_s + "/"))
+    loaded_files = $LOADED_FEATURES.grep(path_regexp)
+    @rango_files = loaded_files.map { |file| file.sub(path_regexp, "") }.sort
+    render "info"
+  }
+end

data/examples/flat/simple_controller.ru

@@ -0,0 +1 @@
+# web service

data/examples/flat/templates/about/author.html.haml

@@ -0,0 +1 @@
+%h1 About Author

data/examples/flat/templates/info.html.haml

@@ -0,0 +1,25 @@
+%h1 Welcome to Rango!
+%ul
+  %li== Ruby version: #{RUBY_VERSION} (#{RUBY_PLATFORM})
+  %li== Rango version: #{Rango::VERSION}
+  %li== Project root: #{Project.root}
+  %li
+    Loaded Rango files:
+    %ul
+      - @rango_files.each do |file|
+        %li= file
+  %li
+    %code $LOAD_PATH:
+    %ul
+      - $LOAD_PATH.each do |path|
+        %li= path
+  %li
+    %code $LOADED_FEATURES:
+    %ul
+      - $LOADED_FEATURES.each do |file|
+        %li= file
+
+%h2 Getting started
+
+%ol
+  %li step 1

data/examples/twitter/Thorfile

@@ -0,0 +1,12 @@
+# encoding: utf-8
+
+# Init hooks
+# Rango::Tasks.hook do
+#   Dir["models/*.rb"].each(&method(:require))
+# end
+
+load "rango/tasks/bundle.thor"
+load "pupu/tasks/pupu.thor"
+load "rango/orm/adapters/datamapper/tasks.thor"
+
+# add your tasks to the tasks directory and give them ".thor" suffix

data/examples/twitter/config.ru

@@ -0,0 +1,48 @@
+#!/usr/bin/env rackup -p 4000 -s thin
+# encoding: utf-8
+
+require "rango"
+Rango.boot
+
+use Rango::Middlewares::Basic
+
+# rack-router
+Rango::Router.use(:rack_router)
+
+use Rack::Router do |router|
+  # with(to: Twitter) do
+    router.map "/:action", to: Twitter
+    router.map "/login",   to: Twitter, action: :login,  name: :login
+    router.map "/logout",  to: Twitter, action: :logout, name: :logout
+    router.map "/signup",  to: Twitter, action: :signup, name: :signup
+    router.map "/",        to: Twitter, action: :index,  name: :index
+    router.map "/:id",     to: Twitter, action: :timeline, name: :timeline, conditions: {id: /^\d+$/}
+  # end
+end
+
+# reload code when something changed
+use Rack::Reloader
+
+# warden authentication
+# wiki.github.com/hassox/warden/setup
+require "warden"
+
+Project.import("views.rb")
+use Warden::Manager do |manager|
+  manager.default_strategies :password
+  manager.failure_app = Twitter
+end
+
+Warden::Manager.serialize_into_session { |user| user.id }
+Warden::Manager.serialize_from_session { |key| User.get(id) }
+
+# Go to login
+Warden::Manager.before_failure do |env, opts|
+  Twitter.route_to env, 'login'
+end
+
+Warden::Strategies.add(:password) do
+  def authenticate!
+    User.new
+  end
+end

data/examples/twitter/factories.rb

@@ -0,0 +1,19 @@
+# encoding: utf-8
+
+require "rango"
+
+Rango.boot
+
+Project.import("models.rb")
+Project.logger.debug("Migrating Database ...")
+
+DataMapper.auto_migrate!
+
+Project.logger.debug("Creating posts ...")
+posts = [
+  ["This is my first post!"],
+  ["This is my second post!"],
+  ["This is my third post!"]]
+posts.each do |body|
+  Post.create(body: body)
+end

data/examples/twitter/init.rb

@@ -0,0 +1,15 @@
+# encoding: utf-8
+
+# dependencies
+Rango.dependency "dm-core", :github => "datamapper/dm-core"
+Rango.dependency "dm-validations", :github => "datamapper/dm-validations"
+Rango.dependency "dm-aggregates", :github => "datamapper/dm-aggregates"
+Rango.dependency "haml", :github => "nex3/haml"
+
+if File.directory?("gems")
+  Gem.path.clear
+  Gem.path.push(Project.path.join("gems").to_s)
+end
+
+# database connection
+DataMapper.setup(:default, "sqlite3://#{Project.root}/development.db")

data/examples/twitter/models.rb

@@ -0,0 +1,13 @@
+# encoding: utf-8
+
+class User
+  include DataMapper::Resource
+  property :login, String, key: true
+  property :body, Text, length: (0..140)
+end
+
+class Post
+  include DataMapper::Resource
+  property :id, Serial
+  property :body, Text, length: (0..140)
+end

data/examples/twitter/run.rb

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby1.9
+# encoding: utf-8
+
+require "rack"
+require "rack/handler/thin"
+
+app = eval("Rack::Builder.new {(\n#{File.read("config.ru")}\n)}.to_app")
+Rack::Handler::Thin.run app, :Port => 4000

data/examples/twitter/settings.rb

@@ -0,0 +1,5 @@
+# encoding: utf-8
+
+Project.configure do
+  self.media_root = "media"
+end

data/examples/twitter/settings_local.rb

@@ -0,0 +1,6 @@
+# encoding: utf-8
+
+# these settings will be merged with settings in main settings file
+Project.configure do
+  self.database_adapter = "sqlite3"
+end

data/examples/twitter/templates/base.html.haml

@@ -0,0 +1,9 @@
+%html
+  %head
+    / TODO: pupu
+    %script{:src => "/mootools/core.js"}
+    != block "head"
+  %body
+    #content
+      != block "content" do
+        Default value

data/examples/twitter/templates/index.html.haml

@@ -0,0 +1,4 @@
+- extends "base.html"
+
+= block "content" do
+  %h1 Home

data/examples/twitter/templates/show.html.haml

@@ -0,0 +1,4 @@
+- extends "base.html"
+
+= block "content" do
+  %p= @post.body

data/examples/twitter/templates/timeline.html.haml

@@ -0,0 +1,10 @@
+- extends "base.html"
+
+- block "head" do
+  / TODO: something timeline-specific
+  %script{:src => "/mootools/core.js"}
+
+= block "content" do
+  %h1 Posts
+  - @posts.each do |post|
+    = post.title