public
Description: Lots of helpers and stuff for making ActiveResource more robust, friendly and ActiveRecord-like
Homepage:
Clone URL: git://github.com/rubyisbeautiful/resource_helper.git
name age message
file MIT-LICENSE Sat Aug 23 13:32:54 -0700 2008 initial import [rubyisbeautiful]
file README Sat Aug 23 14:14:19 -0700 2008 update to README with short examples [rubyisbeautiful]
file Rakefile Loading commit data...
directory doc/ Sat Aug 23 14:16:28 -0700 2008 add rdocs add ActionController methods add Acti... [rubyisbeautiful]
file init.rb Fri Sep 12 07:35:30 -0700 2008 overhaul of module naming and inclusion [rubyisbeautiful]
file install.rb Sat Aug 23 14:14:53 -0700 2008 remove bogus template code [rubyisbeautiful]
directory lib/
directory spec/
directory tasks/
file uninstall.rb Sat Aug 23 13:32:54 -0700 2008 initial import [rubyisbeautiful]
README
ResourceHelper
==============

Helpers for using ActiveResource

In this gem/plugin and documentation, I refer to the notion of client/server or front/back end.  Regardless of your 
architecture, 
whatever is using a model as an ActiveRecord is the server or backend, and whatever is using it as an ActiveResource is
the client or frontend.

Example
=======

Backend stuff
----------------------------
# controller will redir to a callback tag if present, otherwise render whatever
  callback and render :xml => @foo.to_xml
# basic actions necessary for well-behaved resource server
  -- XML index view on every controller
  index
  -- return a new, blank instance in XML
  new
  -- support method for using ActiveResource::count
  count
  
  
Frontend stuff
----------------------------
# ActiveResource Foo
  Foo.count # -> 2
  
# ActiveResource Foo
  Foo.generate -> a new Foo instance
  
# generates a tag for callback, for forms
  %= index_callback_tag(Foo)
  when used with callback on the backend, forms will "come back" to the frontend
  
# generates a blank associated ActiveResource instead of raising an error on a nil association
# ActiveResource::method_missing_with_recover_nil_association
  before: @foo.bar -> raises error, frontend has no idea what a "bar" is if none is provided
  after: @foo.bar  -> even if no bar is associated, will return a blank instance

# useful URL generators for ActiveResource
 Foo.plural_url     -> http://example.com/foos.xml
 Foo.singular_url(1)   -> http://example.com/foo/1



Copyright (c) 2008 [Bryan Taylor], released under the MIT license

see more at http://rubyisbeautiful.com