rack-restful-controller 0.0.1

data/README.markdown

@@ -0,0 +1,80 @@
+# Rack::RESTfulController
+
+I had a crazy idea the other day. Write a class that _looks_ like a "RESTful" Rails controller. Pass it to Rack. And with the help of a little middleware action... voilà!
+
+Only today, when I fleshed it out completely did I think, "This could be useful for writing a quick prototype then moving it to Rails when it's ready." It's _probably_ useful for that too.
+
+This is the fruition of those things.
+
+## Install
+
+    gem install rack-restful-controller -s http://gemcutter.org
+
+## Usage
+
+### config.ru
+
+    require 'rack/restful-controller'
+    
+    class Foo
+      def index
+        "this is the index" # return a string, it becomes [200, {...}, ["this is the index"]]
+      end
+    
+      def show
+      end
+    
+      def create
+        [302, {'Location' => '/42', ...}, ["body"]] # return an array, and it's just passed along to Rack
+      end
+    
+      def edit
+      end
+    
+      def update
+      end
+    
+      def destroy
+      end
+    
+      def foo
+      end
+    
+      def bar
+      end
+    end
+    
+    use Rack::RESTfulController, :collection => {:foo => :get}, :member => {:bar => :get}
+    run Rack::RESTfulController.as(Foo)
+
+## Caveats
+
+* Rack::RESTfulController#call isn't really that robust, but it works. Welcome to suggestions.
+* I don't really like the name of Rack::RESTfulController.as, but it was the best I could think of at the time.
+
+## TODO
+
+* TEST
+* Write a *few* helper methods; redirect_to, *_path, *_url
+
+## License
+
+Copyright (c) 2009 Ryan Carmelo Briones &lt;<ryan.briones@brionesandco.com>&gt;
+
+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/Rakefile

@@ -0,0 +1,25 @@
+require 'rubygems'
+require 'rake/gempackagetask'
+ 
+spec = Gem::Specification.new do |s|
+  s.name = 'rack-restful-controller'
+  s.version = '0.0.1'
+  s.homepage = 'http://github.com/ryanbriones/rack-restful-controller'
+  s.summary = 'Rack application, "RESTful" Rails style.'
+  s.files = FileList['[A-Z]*', 'lib/rack/restful-controller.rb']
+  s.has_rdoc = false
+  s.author = 'Ryan Carmelo Briones'
+  s.email = 'ryan.briones@brionesandco.com'
+
+  s.add_dependency 'rack', '>=1.0.0'
+end
+ 
+package_task = Rake::GemPackageTask.new(spec) {}
+ 
+task :build_gemspec do
+  File.open("#{spec.name}.gemspec", "w") do |f|
+    f.write spec.to_ruby
+  end
+end
+ 
+task :default => [:build_gemspec, :gem]

data/lib/rack/restful-controller.rb

@@ -0,0 +1,92 @@
+module Rack
+  class RESTfulController
+    @@collection_methods = {}
+    @@member_methods = {:edit => :get}
+
+    module App
+      def call(env)
+        @request = Rack::Request.new(env)
+        @params = (@request.params || {}).merge(env['restful.params'])
+        
+        if env['restful.action'] && respond_to?(env['restful.action'])
+          body = send(env['restful.action'])
+          case body
+          when String
+            [200, {'Content-Type' => 'text/html', 'Content-Length' => body.length.to_s}, [body]]
+          when Array
+            body
+          end
+        else
+          body = "Not Found: #{@request.path}"
+          [404, {'Content-Type' => 'text/plain', 'Content-Length' => body.length.to_s}, [body]]
+        end
+      end
+    end
+
+    def self.as(klass)
+      a = klass.new
+      a.extend(App)
+      a
+    end
+
+    def initialize(app, options = {})
+      @app = app
+      @options = options
+
+      if(options.include?(:collection))
+        @@collection_methods.merge!(options[:collection])
+      end
+
+      if(options.include?(:member))
+        @@member_methods.merge!(options[:member])
+      end
+    end
+
+    def call(env)
+      req = Rack::Request.new(env)
+
+      env['restful.params'] = {}
+
+      if req.get? && req.path == '/'
+        env['restful.action'] = :index
+      elsif req.get? && (match = req.path.match(/^\/(.+?)(?:\/(.+))?$/))
+        if(match[2] && @@member_methods[match[2].to_sym] == :get)
+          env['restful.action'] = match[2].to_sym
+          env['restful.params'] = {'id' => match[1]}
+        elsif(match[2] && @@member_methods[match[2].to_sym] != :get)
+        elsif(!match[2] && @@collection_methods[match[1].to_sym] == :get)
+          env['restful.action'] = match[1].to_sym
+        else
+          env['restful.action'] = :show
+          env['restful.params'] = {'id' => match[1]}
+        end
+      elsif req.post? && req.path == '/'
+        env['restful.action'] = :create
+      elsif (req.put? || mimic_put?(req)) && (match = req.path.match(/^\/(.+?)(?:\/(.+))?$/))
+        if(match[2] && @@member_methods[match[2].to_sym] == :put)
+          env['restful.action'] = match[2].to_sym
+          env['restful.params'] = {'id' => match[1]}
+        elsif(match[2] && @@member_methods[match[2].to_sym] != :put)
+        else
+          env['restful.action'] = :update
+          env['restful.params'] = {'id' => match[1]}
+        end
+      elsif (req.delete? || mimic_delete?(req)) && (match = req.path.match(/^\/(.+)$/))
+        env['restful.action'] = :destroy
+        env['restful.params'] = {'id' => match[1]}
+      end
+
+      env['restful.params'].merge!('action' => env['restful.action'].to_s)
+      
+      @app.call(env)
+    end
+
+    def mimic_put?(req)
+      req.post? && req.params['_method'] == 'put'
+    end
+
+    def mimic_delete?(req)
+      req.post? && req.params['_method'] == 'delete'
+    end
+  end
+end

metadata

@@ -0,0 +1,66 @@
+--- !ruby/object:Gem::Specification 
+name: rack-restful-controller
+version: !ruby/object:Gem::Version 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Ryan Carmelo Briones
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-10-26 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rack
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.0.0
+    version: 
+description: 
+email: ryan.briones@brionesandco.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- Rakefile
+- README.markdown
+- lib/rack/restful-controller.rb
+has_rdoc: true
+homepage: http://github.com/ryanbriones/rack-restful-controller
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Rack application, "RESTful" Rails style.
+test_files: []
+