padrino-fields 0.3.3

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/Gemfile

@@ -0,0 +1,40 @@
+source :rubygems
+
+group :other do
+  gem "builder", ">= 2.1.2"
+end
+
+group :db do
+  gem "dm-core", ">= 1.0"
+  gem "dm-migrations", ">= 1.0"
+  gem "dm-validations", ">= 1.0"
+  gem "dm-aggregates", ">= 1.0"
+  gem "dm-sqlite-adapter", ">= 1.0"
+end
+
+group :development do
+  gem "rcov"
+  gem "jeweler"
+  gem "rake",  ">= 0.8.7"
+  gem "mocha", ">= 0.9.8"
+  gem "rack-test", ">= 0.5.0"
+  gem "fakeweb",  ">=1.2.8"
+  gem "webrat", ">= 0.5.1"
+  gem "haml", ">= 2.2.22"
+  gem "phocus"
+  gem "shoulda", ">= 2.10.3"
+  gem "uuid", ">= 2.3.1"
+  gem "bcrypt-ruby", :require => "bcrypt"
+  platforms :mri_18 do
+    gem "ruby-prof", ">= 0.9.1"
+    gem "system_timer", ">= 1.0"
+  end
+  platforms :mri do
+    gem "memcached", ">= 0.20.1"
+    gem 'dalli',     ">=1.0.2"
+  end
+end
+
+gem "padrino"
+gem "padrino-core"
+gem "padrino-helpers"

data/Gemfile.lock

@@ -0,0 +1,133 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    activesupport (3.0.5)
+    addressable (2.2.4)
+    bcrypt-ruby (2.1.4)
+    builder (3.0.0)
+    dalli (1.0.2)
+    data_objects (0.10.3)
+      addressable (~> 2.1)
+    dm-aggregates (1.0.2)
+      dm-core (~> 1.0.2)
+    dm-core (1.0.2)
+      addressable (~> 2.2)
+      extlib (~> 0.9.15)
+    dm-do-adapter (1.0.2)
+      data_objects (~> 0.10.2)
+      dm-core (~> 1.0.2)
+    dm-migrations (1.0.2)
+      dm-core (~> 1.0.2)
+    dm-sqlite-adapter (1.0.2)
+      dm-do-adapter (~> 1.0.2)
+      do_sqlite3 (~> 0.10.2)
+    dm-validations (1.0.2)
+      dm-core (~> 1.0.2)
+    do_sqlite3 (0.10.3)
+      data_objects (= 0.10.3)
+    extlib (0.9.15)
+    fakeweb (1.3.0)
+    git (1.2.5)
+    haml (3.0.25)
+    http_router (0.5.4)
+      rack (>= 1.0.0)
+      url_mount (~> 0.2.1)
+    i18n (0.5.0)
+    jeweler (1.5.2)
+      bundler (~> 1.0.0)
+      git (>= 1.2.5)
+      rake
+    macaddr (1.0.0)
+    mail (2.2.15)
+      activesupport (>= 2.3.6)
+      i18n (>= 0.4.0)
+      mime-types (~> 1.16)
+      treetop (~> 1.4.8)
+    memcached (1.2.1)
+    mime-types (1.16)
+    mocha (0.9.12)
+    nokogiri (1.4.4)
+    padrino (0.9.23)
+      padrino-admin (= 0.9.23)
+      padrino-cache (= 0.9.23)
+      padrino-core (= 0.9.23)
+      padrino-gen (= 0.9.23)
+      padrino-helpers (= 0.9.23)
+      padrino-mailer (= 0.9.23)
+    padrino-admin (0.9.23)
+      padrino-core (= 0.9.23)
+      padrino-helpers (= 0.9.23)
+    padrino-cache (0.9.23)
+      padrino-core (= 0.9.23)
+    padrino-core (0.9.23)
+      activesupport (>= 3.0.0)
+      http_router (~> 0.5.4)
+      sinatra (~> 1.2.0)
+      thor (>= 0.14.3)
+      tzinfo
+    padrino-gen (0.9.23)
+      bundler (>= 1.0.2)
+      git
+      padrino-core (= 0.9.23)
+    padrino-helpers (0.9.23)
+      i18n (>= 0.4.1)
+      padrino-core (= 0.9.23)
+    padrino-mailer (0.9.23)
+      mail (>= 2.2.0)
+      padrino-core (= 0.9.23)
+    phocus (1.1)
+    polyglot (0.3.1)
+    rack (1.2.1)
+    rack-test (0.5.7)
+      rack (>= 1.0)
+    rake (0.8.7)
+    rcov (0.9.9)
+    ruby-prof (0.9.2)
+    shoulda (2.11.3)
+    sinatra (1.2.0)
+      rack (~> 1.1)
+      tilt (>= 1.2.2, < 2.0)
+    system_timer (1.0)
+    thor (0.14.6)
+    tilt (1.2.2)
+    treetop (1.4.9)
+      polyglot (>= 0.3.1)
+    tzinfo (0.3.24)
+    url_mount (0.2.1)
+      rack
+    uuid (2.3.1)
+      macaddr (~> 1.0)
+    webrat (0.7.3)
+      nokogiri (>= 1.2.0)
+      rack (>= 1.0)
+      rack-test (>= 0.5.3)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bcrypt-ruby
+  builder (>= 2.1.2)
+  dalli (>= 1.0.2)
+  dm-aggregates (>= 1.0)
+  dm-core (>= 1.0)
+  dm-migrations (>= 1.0)
+  dm-sqlite-adapter (>= 1.0)
+  dm-validations (>= 1.0)
+  fakeweb (>= 1.2.8)
+  haml (>= 2.2.22)
+  jeweler
+  memcached (>= 0.20.1)
+  mocha (>= 0.9.8)
+  padrino
+  padrino-core
+  padrino-helpers
+  phocus
+  rack-test (>= 0.5.0)
+  rake (>= 0.8.7)
+  rcov
+  ruby-prof (>= 0.9.1)
+  shoulda (>= 2.10.3)
+  system_timer (>= 1.0)
+  uuid (>= 2.3.1)
+  webrat (>= 0.5.1)

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Steven Garcia
+
+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/README.markdown

@@ -0,0 +1,189 @@
+# PadrinoFields
+
+Forms made easy for the **[Padrino Framework](http://www.padrinorb.com)**
+
+Takes the pain out of building forms. Generates inputs, labels and field hints with a minimal and flexible DSL. Currently only supports **[DataMapper](http://datamapper.org/)**, but plugging more ORMs in will be trivial due to modular design (See below)
+
+## Installation
+
+Install the gem:
+
+    gem install padrino-fields
+
+Add it to your Gemfile:
+
+    gem "padrino-fields"
+    
+
+Initialize it in your **app.rb**
+
+    register PadrinoFields
+    
+    set :default_builder, 'PadrinoFieldsBuilder'
+
+## Usage
+
+The heart of **PadrinoFields** is the **:input** method
+
+    - form_for @user do |f|
+      = f.input :username
+      = f.input :password
+      = f.submit
+
+This will generate a form with labels for username and password - supplying the appropriate inputs, labels and error messages on missing/invalid fields. **PadrinoFields** looks at your database columns to generate default inputs.
+
+### Field Customization
+
+Override the default input type like so:
+
+    = f.input :description, :as => :text
+    = f.input :joined_on,   :as => :string
+    = f.accept_terms,       :as => :boolean
+
+Add custom label text, field hints and more:
+
+    = f.input :username, :caption => 'You will login with this name'
+    = f.input :password, :hint => 'Letters and numbers only'
+
+Disable labels, hints or errors:
+
+    = f.input :username, :caption => false
+    = f.input :password, :hint => false
+    = f.input :email,    :disabled => true
+
+Pass html attribute straight to the input:
+
+    = f.input :username,    :input_html => { :class => 'special' }
+    = f.input :password,    :input_html => { :maxlength => 20 }
+    = f.input :remember_me, :input_html => { :value => '1' }
+
+### Options / Collections
+
+Options can be arrays or ranges, and when a **:options** is given the **:select** input will be rendered by default, so we don't need to pass the **:as => :select** option. 
+
+    = f.input :user, :options => User.all.map(&:name)
+
+Use ranges as options for your select tags
+
+    = f.input :year, :options => (1950..Time.now.year)
+
+Options may also be rendered as **:radios** and **:checks**
+
+    = f.input :user, :options => User.all.map(&:name), :as => :radios
+
+You can produce optgroups using **:grouped_options**
+
+    # Using a Hash
+    options = {
+      "Friends" => ["Yoda","Obiwan"],
+      "Enemies" => ["Palpatine","Darth Vader"]
+    }
+    
+    # Using an Array
+    options = [
+      ["Friends",["Yoda","Obiwan"],
+      ["Enemies", ["Palpatine","Darth Vader"]]
+    ]
+    
+    = f.input :user, :grouped_options => options
+
+### Available Inputs
+
+Mapping       | Input           | Column Type                          
+:-------------|:----------------|:------------------------------------
+**:boolean**  |check box        |boolean                              
+**:string**   |text field       |string                               
+**:email**    |email field      |string with name matching "email"    
+**:url**      |url field        |string with name matching "url"      
+**:tel**      |tel field        |string with name matching "phone"    
+**:password** |password field   |string with name matching "password" 
+**:search**   |search           |string with name matching "search"   
+**:text**     |text area        |text                                 
+**:file**     |file field       |string, responding to file methods   
+**:number**   |number field     |integer, float, decimal              
+**:date**     |date field       |date, datetime, timestamps           
+**:select**   |select           |-                                    
+**:radios**   |radio buttons    |-                                    
+**:checks**   |check boxes      |-                                    
+
+
+### Validations
+
+By default all inputs are optional. **PadrinoFields** looks at your model validations to see if a field's presence is required and will mark it by prepending a * to the label. 
+
+    # app/models/person.rb
+    class Person
+      validates_presence_of :name
+    
+    # app/views/people/_form.haml
+    = f.input :name
+    
+    => <label><abbr>*<abbr>Name</label><input ...
+
+You can also do it manually with the **:required** option
+
+    = f.input :email, :required => true
+
+### Settings
+
+You can override a few default settings by creating a lib file as follows:
+
+    PadrinoFields::Settings.configure do |config|
+      
+      config.container = :p
+      # Tag which wraps the inputs and labels
+      
+      config.label_required_marker = "<abbr>*</abbr>"
+      # Visual indicator of a required field
+      
+      config.label_required_marker_position = :prepend
+      # Placement of marker, either :append or :prepend (default)
+      
+    end
+
+
+## ORM Support
+
+So far only Datamapper is supported, but since the code is decoupled it should be relatively easy to support others:
+
+1. Clone **padrino-fields/orms/datamapper.rb** and extend your ORM in a similar fashion
+2. Clone **test/fixtures/datamapper** and substitute the models with your ORM
+3. Clone **test/test_datamapper.rb** to write tests
+4. Open **lib/padrino-fields/form_builder.rb**
+
+Require your orm file and include its module as follows:
+
+    require File.expand_path(File.dirname(__FILE__) + '/orms/mycoolorm') if defined?(MyCoolOrm)
+
+    module Padrino
+      module Helpers
+        module FormBuilder
+          class PadrinoFields < AbstractFormBuilder #:nodoc:
+        
+            include PadrinoFields::MyCoolOrm if defined?(MyCoolOrm)
+
+## Todo
+
+* Add country select
+* Generators for config and views
+* I18n integration
+* More documentation
+
+## Bug reports
+
+If you discover any bugs, feel free to create an issue on GitHub. Please add as much information as possible to help us fix the problem. You can be an even bigger help by forking and sending a pull request. Be sure to include tests with your code!
+
+[http://github.com/activestylus/padrino-field/issues](http://github.com/activestylus/padrino-field/issues)
+
+## Credit
+
+This gem borrows heavily from the following projects:
+
+* [Formtastic](http://github.com/justinfrench/formtastic)
+* [SimpleForm](http://github.com/plataformatec/simple_form)
+
+Many thanks to [Justin French](https://github.com/justinfrench) and [Jose Valim](https://github.com/josevalim) for the inspiration. Extra shouts to [Nathan Esquenazi](https://github.com/nesquena) and [Davide d'Agostino](https://github.com/DAddYE) for lending a hand on the [google group](https://groups.google.com/forum/#!forum/padrino)
+
+## License
+
+MIT License. Copyright 2011 Steven Garcia

data/Rakefile

@@ -0,0 +1,53 @@
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "padrino-fields"
+  gem.homepage = "http://github.com/activestylus/padrino-fields"
+  gem.license = "MIT"
+  gem.summary = %Q{Advanced form helpers for Padrino framework}
+  gem.description = %Q{Smart fields for your forms, similar to Formtastic or SimpleForm}
+  gem.email = "stevendgarcia@gmail.com"
+  gem.authors = ["Steven Garcia"]
+  # Include your dependencies below. Runtime dependencies are required when using your gem,
+  # and development dependencies are only needed for development (ie running rake tasks, tests, etc)
+  #  gem.add_runtime_dependency 'jabber4r', '> 0.1'
+  #  gem.add_development_dependency 'rspec', '> 1.2.3'
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+require 'rcov/rcovtask'
+Rcov::RcovTask.new do |test|
+  test.libs << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "padrino-fields #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.3.3