reststop 0.2.0 → 0.2.0.50

data/CHANGELOG.txt

@@ -1,3 +1,9 @@
+=== 0.2.1 :: In Progress...
+
+  * Restr should now work properly with Rails 2.x (fixes bug #17421).
+  * R helper method should now work properly when a Restful object is fed as
+    input along with a custom action.
+
 === 0.2.0 :: 2007-12-10
 
   * It is now possible to specify the format for rendering a page by appending
@@ -17,6 +23,7 @@
   * Pages now correctly return HTTP status code 501 when an unimplemented controller 
     method is called. ActiveRecord::NotFound exceptions are caught and return 404 
     status.
+  * R helper now works for routing RESTful controllers.
 
 === 0.1.0 :: 2007-07-30
 

data/History.txt

@@ -0,0 +1 @@
+See CHANGELOG.txt

data/Manifest.txt

@@ -1,4 +1,5 @@
 CHANGELOG.txt
+History.txt
 LICENSE.txt
 Manifest.txt
 README.txt

data/README.txt

@@ -1,18 +1,15 @@
 = Reststop
 
-<i>Copyright 2007 Urbacon Ltd.</i>
-
-For info and downloads please see:
+<b>Reststop makes it easy to write RESTful[http://en.wikipedia.org/wiki/Representational_State_Transfer] 
+applications in Camping[http://camping.rubyforge.org/files/README.html].</b>
 
-  http://rubyforge.org/projects/reststop/
+For info and downloads please see http://rubyforge.org/projects/reststop
 
-You can contact the author at:
 
-  matt at roughest dot net
-  
+*Author*::    Matt Zukowski (matt at roughest dot net)
+*Copyright*:: Copyright (c) 2007 Urbacon Ltd.
+*License*::   GNU Lesser General Public License Version 3
 
-<b>Reststop makes it easy to write RESTful[http://en.wikipedia.org/wiki/Representational_State_Transfer] 
-applications in Camping[http://camping.rubyforge.org/files/README.html].</b>
 
 For an example of a complete Reststop-based Camping app, have a look at 
 http://reststop.rubyforge.org/svn/trunk/examples/blog.rb
@@ -98,7 +95,7 @@ example of RESTful interaction with Restr:
   kitten = Restr.put('http://example.com/kittens/1.xml', kitten)
 
 
-----
+== License
 
 Reststop is free software; you can redistribute it and/or modify
 it under the terms of the GNU Lesser General Public License as published 

data/Rakefile

@@ -18,10 +18,11 @@ GEM_NAME = "reststop"
 RUBYFORGE_PROJECT = "reststop" # The unix name for your project
 HOMEPATH = "http://#{RUBYFORGE_PROJECT}.rubyforge.org"
 
+ENV['NODOT'] = '1'
 
 NAME = "reststop"
-REV = nil
-#REV = `svn info`[/Revision: (\d+)/, 1] rescue nil
+#REV = nil
+REV = `svn info`[/Revision: (\d+)/, 1] rescue nil
 VERS = ENV['VERSION'] || (Reststop::VERSION::STRING + (REV ? ".#{REV}" : ""))
                           CLEAN.include ['**/.*.sw?', '*.gem', '.config']
 RDOC_OPTS = ['--quiet', '--title', "#{NAME} #{VERS} documentation",

data/lib/restr.rb

@@ -90,7 +90,7 @@ class Restr
     end
     
     unless method_mod == 'Get'
-      req.set_form_data(params, ';')
+      req.set_form_data(params, '&')
     end
     
     @@log.debug("Sending #{method.inspect} request to #{url.inspect} with data #{params.inspect}"+
@@ -115,8 +115,8 @@ class Restr
         return res.body
       end
     else
-      $LAST_ERROR_BODY = res.body # FIXME: this is dumb
-      @@log.error("Got error resposne '#{res.message}(#{res.code})': #{$LAST_ERROR_BODY}") if @@log
+      $LAST_ERROR_BODY = res.body # FIXME: this is dumb... need a better way of reporting errors
+      @@log.error("Got error response '#{res.message}(#{res.code})': #{$LAST_ERROR_BODY}") if @@log
       res.error!      
     end
   end

data/lib/reststop.rb

@@ -100,12 +100,12 @@ module Camping
   # The format can also be specified in other ways (shown in this order 
   # of precedence):
   #
-  #   # By providing a second parameter to render()
-  #     (eg: <tt>render(:foo, :HTML)</tt>)
-  #   # By setting the @format variable
-  #   # By providing a 'format' parameter in the request (i.e. @input[:format])
-  #   # By adding a file-format extension to the url (e.g. /items.xml or 
-  #     /items/2.html).
+  # 1. By providing a second parameter to render()
+  #    (eg: <tt>render(:foo, :HTML)</tt>)
+  # 2. By setting the @format variable
+  # 3. By providing a 'format' parameter in the request (i.e. @input[:format])
+  # 4. By adding a file-format extension to the url (e.g. /items.xml or 
+  #    /items/2.html).
   #
   # For example, you could have:
   #
@@ -237,8 +237,8 @@ module Camping
       # * list
       # 
       # Routes will be automatically created based on the resource name fed to the
-      # REST method. Note that your class must have the same (but CamelCaps'ed) 
-      # name as the resource name. So if your resource name is 'kittens', 
+      # REST method. <b>Your class must have the same (but CamelCaps'ed) 
+      # name as the resource name.</b> So if your resource name is 'kittens', 
       # your controller class must be Kittens.
       #
       # For example:
@@ -267,11 +267,22 @@ module Camping
       #     end
       #   end
       #
+      # Custom actions are also possible. For example, to implement a 'meow' 
+      # action simply add a 'meow' method to the above controller:
       #
-      # Optionally, you can specify a :prefix key that will prepend this
-      # string to the routes. For example, this will create all of the above
-      # routes, prefixed with '/pets' (i.e. POST '/pets/kittens', 
-      # GET '/pets/kittens/(\d+)', etc.)
+      #   # POST/GET/PUT/DELETE /kittens/meow
+      #   # POST/GET/PUT/DELETE /kittens/(\d+)/meow
+      #   def meow(id)
+      #   end
+      #
+      # Note that a custom action will respond to all four HTTP methods 
+      # (POST/GET/PUT/DELETE).
+      #
+      # Optionally, you can specify a <tt>:prefix</tt> key that will prepend the
+      # given string to the routes. For example, the following will create all 
+      # of the above routes, prefixed with "/pets" 
+      # (i.e. <tt>POST '/pets/kittens'</tt>,  <tt>GET '/pets/kittens/(\d+)'</tt>, 
+      # etc.):
       #
       #   module Foobar::Controllers
       #     class Items < REST 'kittens', :prefix => '/pets'
@@ -279,8 +290,9 @@ module Camping
       #     end
       #   end
       #
-      # Additionally, format-based routing is possible. For example to get 
-      # a list of kittens in XML format, place a GET call to /kittens.xml.
+      # Format-based routing similar to that in ActiveResource is also implemented. 
+      # For example, to get a list of kittens in XML format, place a 
+      # <tt>GET</tt> call to <tt>/kittens.xml</tt>.
       # See the documentation for the render() method for more info.
       #
       def REST(r, options = {})
@@ -402,7 +414,8 @@ module Camping
       if Controllers.constants.include?(cl = c.class.name.split("::").last.pluralize)
         path = "/#{cl.underscore}/#{c.id}"
         path << ".#{@format.to_s.downcase}" if @format
-        path << "?#{g}" unless g.empty? # FIXME: undefined behaviour if there are multiple arguments left
+        path << "/#{g.shift}" unless g.empty? 
+        # FIXME: undefined behaviour if there are multiple arguments left... maybe we should allow for arbitrary params as a Hash?
         self / path
       elsif c.respond_to?(:restful?) && c.restful?
         base = c.name.split("::").last.underscore

metadata

@@ -1,35 +1,33 @@
 --- !ruby/object:Gem::Specification 
-rubygems_version: 0.9.2
-specification_version: 1
 name: reststop
 version: !ruby/object:Gem::Version 
-  version: 0.2.0
-date: 2007-12-18 00:00:00 -05:00
-summary: Convenient RESTfulness for all your Camping needs (i.e. makes it easy to implement RESTful controllers in Camping).
-require_paths: 
-- lib
-email: matt@roughest.net
-homepage: http://reststop.rubyforge.org
-rubyforge_project: reststop
-description: Convenient RESTfulness for all your Camping needs (i.e. makes it easy to implement RESTful controllers in Camping).
-autorequire: 
-default_executable: 
-bindir: bin
-has_rdoc: true
-required_ruby_version: !ruby/object:Gem::Version::Requirement 
-  requirements: 
-  - - ">"
-    - !ruby/object:Gem::Version 
-      version: 0.0.0
-  version: 
+  version: 0.2.0.50
 platform: ruby
-signing_key: 
-cert_chain: 
-post_install_message: 
 authors: 
 - Matt Zukowski
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-03-10 00:00:00 -04:00
+default_executable: 
+dependencies: []
+
+description: Convenient RESTfulness for all your Camping needs (i.e. makes it easy to implement RESTful controllers in Camping).
+email: matt@roughest.net
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- CHANGELOG.txt
+- History.txt
+- LICENSE.txt
+- Manifest.txt
+- README.txt
 files: 
 - CHANGELOG.txt
+- History.txt
 - LICENSE.txt
 - Manifest.txt
 - README.txt
@@ -41,21 +39,32 @@ files:
 - setup.rb
 - test/reststop_test.rb
 - test/test_helper.rb
-test_files: 
-- test/reststop_test.rb
+has_rdoc: true
+homepage: http://reststop.rubyforge.org
+post_install_message: 
 rdoc_options: 
 - --main
 - README.txt
-extra_rdoc_files: 
-- CHANGELOG.txt
-- LICENSE.txt
-- Manifest.txt
-- README.txt
-executables: []
-
-extensions: []
-
+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: []
 
-dependencies: []
-
+rubyforge_project: reststop
+rubygems_version: 1.0.1
+signing_key: 
+specification_version: 2
+summary: Convenient RESTfulness for all your Camping needs (i.e. makes it easy to implement RESTful controllers in Camping).
+test_files: 
+- test/reststop_test.rb