README.rdoc in param_checker-0.0.2 vs README.rdoc in param_checker-0.0.4
- old
+ new
@@ -14,47 +14,47 @@
bundle install
== Usage
-Include the ParamChecker module where ever you like. I usually put it into my Rails +ApplicationController.rb+
+Include the ParamChecker module where ever you like. I usually put it into my Rails <tt>ApplicationController.rb</tt>
class ApplicationController < ActionController::Base
include ParamChecker
end
-You can then simply call +check_string_param(param_to_check, "my default", ["foo", "bar"])+ in every controller.
+You can then simply call <tt>check_string(param_to_check, "my default", ["foo", "bar"])</tt> in every controller.
Instead of including the module you could also call all functions of the module directly.
- ParamChecker.check_string_param(param_to_check, "my default", ["foo", "bar"])
+ ParamChecker.check_string(param_to_check, "my default", ["foo", "bar"])
There are currently 5 supported functions:
-* +check_integer_param(param, default, min, max)+
-* +check_float_param(param, default, min, max)+
-* +check_string_param(param, default, allowed)+
-* +check_symbol_param(param, default, allowed)+
-* +check_boolean_param(param, default)+
+ check_integer(param, default, min, max)
+ check_float(param, default, min, max)
+ check_string(param, default, allowed)
+ check_symbol(param, default, allowed)
+ check_boolean(param, default)
+param+ is always the string parameter to check. +default+ is a value that is returned when +param+ does not succeed the check.
-+min+ and +max+ in +check_integer_param+ and +check_float_param+ are the minimum and maximum allowed values of param. Both +min+ and +max+ options are optional. If they are not provided then no range is checked at all.
-+allowed+ in +check_string_param+ and +check_symbol_param+ represent the allowed values of +param+. They can be either a string (resp. a symbol for +check_symbol_param+), a regular expression, or an array of strings (resp. symbols for +check_symbol_param+).
-+check_boolean_param+ evaluates "1" or "true" string as true and "0" or "false" string to false.
-All functions return the parsed and type cast value (check_integer_param returns an integer, check_symbol_param returns a symbol, and so on).
++min+ and +max+ in +check_integer+ and +check_float+ are the minimum and maximum allowed values of param. Both +min+ and +max+ options are optional. If they are not provided then no range is checked at all.
++allowed+ in +check_string+ and +check_symbol+ represent the allowed values of +param+. They can be either a string (resp. a symbol for +check_symbol+), a regular expression, or an array of strings (resp. symbols for +check_symbol+).
++check_boolean+ evaluates "1" or "true" string as true and "0" or "false" string to false.
+All functions return the parsed and type cast value (check_integer returns an integer, check_symbol returns a symbol, and so on).
== Examples
Below are some simple examples how I use those function in my controllers.
# +max+ is not provided in this case. I just want to ensure that page is bigger than 1 and otherwise return 1.
- page = check_integer_param(params[:page], 1, 1)
+ page = check_integer(params[:page], 1, 1)
# Returns "name" if params[:field] is not "name" or "address"
- field = check_string_param(params[:field], "name", ["name", "address"])
+ field = check_string(params[:field], "name", ["name", "address"])
# Return the boolean if params[:accepted] is a valid boolean representation, and the default false otherwise.
- accepted = check_boolean_param(params[:accepted], false)
+ accepted = check_boolean(params[:accepted], false)
== Testing
ParamChecker uses RSpec for testing and has a rake task for executing the provided specs