README

   1 = Description
   2
   3 Railsex - pronounced "Rails Extensions" OR "Ex Rails" ( easier to say ) - is a plugin for all those cool/good to have/experimental features
   4 which cannot possibly be in core due to their nature. As rails itself, this plugin is supposed to be a community effort. So, do chime in !
   5
   6 = Install
   7
   8 * Using gem
   9
  10       $ sudo gem install railsex
  11       $ gem unpack railsex vendor/plugins
  12
  13 * Using git
  14
  15       $ git clone git://repo.or.cz/railsex.git vendor/plugins
  16
  17 = Usage
  18
  19 Railsex loads extensions only on demand because of the variety of options it provides.
  20
  21 You will need to load the extension in your environment.rb configuration block with following syntax :
  22
  23   config.after_initialize do
  24     config.extensions = [:respond_to, :lazy_attributes, :console]
  25   end
  26
  27 The plugin requires Rails 2.0.x or higher version.
  28
  29 = Current Extensions
  30
  31 * respond_to
  32 * lazy_attributes
  33 * console
  34
  35 = Features
  36
  37 == Argument-less support for respond_to :
  38
  39 In your controller you can have :
  40
  41   respond_to do
  42     html
  43     xml  { render :xml => @article }
  44   end
  45
  46 == Lazy attributes to provide partial updates
  47
  48 You can declare lazy attributes in your model definition :
  49
  50   class Person < ActiveRecord::Base
  51     lazy_attributes :history, :bio
  52   end
  53
  54 In this case, when you do @person.save, ActiveRecord will include bio and history columns in UPDATE query only if you accessed
  55 @person.history= or @person.bio= methods.
  56
  57 == Very common console tricks
  58
  59 * [] finders for model so you can do Article[1], Article[:all]
  60 * "log_to" function to print out db queries to rails irb console
  61
  62 = Primary Authors
  63
  64 Pratik Naik - http://m.onkey.org
  65
  66 Unknown people from the internet for "console" extension
  67