formotion 0.0.1

data/.gitignore

@@ -0,0 +1,10 @@
+.repl_history
+build
+resources/*.nib
+resources/*.momd
+resources/*.storyboardc
+.DS_STORE
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/Formotion.gemspec

@@ -0,0 +1,19 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/formotion/version', __FILE__)
+
+Gem::Specification.new do |s|
+  s.name        = "formotion"
+  s.version     = Formotion::VERSION
+  s.authors     = ["Clay Allsopp"]
+  s.email       = ["clay.allsopp@gmail.com"]
+  s.homepage    = "https://github.com/clayallsopp/Formotion"
+  s.summary     = "Making iOS Forms insanely great with RubyMotion"
+  s.description = "Making iOS Forms insanely great with RubyMotion"
+
+  s.files         = `git ls-files`.split($\)
+  s.test_files    = s.files.grep(%r{^(test|spec|features)/})
+  s.require_paths = ["lib"]
+
+  s.add_dependency "bubble-wrap"
+  s.add_development_dependency 'rake'
+end

data/README.md

@@ -0,0 +1,168 @@
+# Formotion
+
+Make this:
+
+![Complex data form](http://i.imgur.com/TMwXI.png)
+
+using just this:
+
+```ruby
+@form = Formotion::Form.new({
+  sections: [{
+    title: "Register",
+    rows: [{
+      title: "Email",
+      key: :email,
+      placeholder: "me@mail.com",
+      type: :email,
+      auto_correction: :no,
+      auto_capitalization: :none
+    }, {
+      title: "Password",
+      key: :password,
+      placeholder: "required",
+      type: :string,
+      secure: true
+    }, {
+      title: "Password",
+      subtitle: "Confirmation"
+      key: :confirm,
+      placeholder: "required",
+      type: :string,
+      secure: true
+    }, {
+      title: "Remember?",
+      key: :remember,
+      type: :switch,
+    }]
+  }, {
+    title: "Account Type",
+    key: :account_type,
+    select_one: true,
+    rows: [{
+      title: "Free",
+      key: :free,
+      type: :check,
+    }, {
+      title: "Basic",
+      value: true,
+      key: :basic,
+      type: :check,
+    }, {
+      title: "Pro",
+      key: :pro,
+      type: :check,
+    }]
+  }, {
+    rows: [{
+      title: "Sign Up",
+      type: :submit,
+    }]
+  }]
+})
+
+@form_controller = FormController.alloc.initWithForm(@form)
+@window.rootViewController = @form_controller
+```
+
+And after the user enters some data, do this:
+
+```ruby
+@form.render
+=> {:email=>"me@email.com", :password=>"password", 
+    :confirm=>"password", :remember=>true, :account_type=>:pro}
+```
+
+## Installation
+
+`gem install formotion`
+
+In your `Rakefile`:
+
+`require 'formotion'`
+
+## Usage
+
+### Initialize
+
+You can initialize a `Formotion::Form` using either a hash (as above) or the DSL:
+
+```ruby
+form = Formotion::Form.new
+
+form.build_section do |section|
+  section.title = "Title"
+
+  section.build_row do |row|
+    row.title = "Label"
+    row.subtitle = "Placeholder"
+  end
+end
+```
+
+Then attach it to a `Formotion::Controller` and you're ready to rock and roll:
+
+```ruby
+@controller = Formotion::Controller.alloc.initWithForm(form)
+self.navigationController.pushViewController(@controller, animated: true)
+```
+
+### Retreive
+
+You have `form#submit`, `form#on_submit`, and `form#render` at your disposal. Here's an example:
+
+```ruby
+class PeopleController < Formotion::Controller
+  def viewDidLoad
+    self.navigationItem.rightBarButtonItem = UIBarButtonItem.alloc.initWithBarButtonSystemItem(UIBarButtonSystemItemSave, target:self, action:'submit')
+  end
+
+  def submit
+    data = self.form.render
+
+    person.name = data[:name]
+    person.address = data[:address]
+  end
+end
+```
+
+Why would you use `form#on_submit`? In case you want to use `Formotion::RowType::SUBMIT`. Ex:
+
+```ruby
+@form = Formotion::Form.new({
+  sections: [{
+  ...
+  }, {
+    rows: [{
+      title: "Save",
+      type: Formotion::RowType::SUBMIT
+    }]
+  }]
+})
+
+@form.on_submit do |form|
+  # do something with form.render
+end
+```
+
+`form#submit` just triggers `form#on_submit`.
+
+### Data Types
+
+Formotion current supports static and editable text, switches, and checkboxes.
+
+`Formotion::Form`, `Formotion::Section`, and `Formotion::Row` all respond to a `::PROPERTIES` attribute. These are settable as an attribute (ie `section.title = 'title'`) or in the initialization hash (ie `{sections: [{title: 'title', ...}]}`). Check the comments in the 3 main files (`form.rb`, `section.rb`, and `row.rb` for details on what these do).
+
+See the [KitchenSink example](https://github.com/clayallsopp/formotion/tree/master/examples/KitchenSink) for a bunch of options in action.
+
+## Forking
+
+Feel free to fork and submit pull requests! And if you end up using Formotion in your app, I'd love to hear about your experience.
+
+## Todo
+
+- Not very efficient right now (creates a unique reuse idenitifer for each cell)
+- More data entry types (dates, etc)
+- More tests
+- Styling/overriding the form for custom UITableViewDelegate/Data Source behaviors.
+- Custom cell text field alignments

data/Rakefile

@@ -0,0 +1,11 @@
+$:.unshift("/Library/RubyMotion/lib")
+require 'motion/project'
+require "bundler/gem_tasks"
+
+$:.unshift("./lib/")
+require './lib/formotion'
+
+Motion::Project::App.setup do |app|
+  # Use `rake config' to see complete project settings.
+  app.name = 'Formotion'
+end

data/app/app_delegate.rb

@@ -0,0 +1,68 @@
+class AppDelegate
+  def application(application, didFinishLaunchingWithOptions:launchOptions)
+    @window = UIWindow.alloc.initWithFrame(UIScreen.mainScreen.bounds)
+
+    form = Formotion::Form.new({
+      sections: [{
+        title: "Register",
+        rows: [{
+          title: "Email",
+          key: :email,
+          placeholder: "me@mail.com",
+          type: :email,
+          auto_correction: :no,
+          auto_capitalization: :none
+        }, {
+          title: "Password",
+          key: :password,
+          placeholder: "required",
+          type: :string,
+          secure: true
+        }, {
+          title: "Password",
+          subtitle: "Confirmation",
+          key: :confirm,
+          placeholder: "required",
+          type: :string,
+          secure: true
+        }, {
+          title: "Switch",
+          key: :switch,
+          type: :switch,
+        }]
+      }, {
+        title: "Account Type",
+        key: :account_type,
+        select_one: true,
+        rows: [{
+          title: "Free",
+          key: :free,
+          type: :check,
+        }, {
+          title: "Basic",
+          value: true,
+          key: :basic,
+          type: :check,
+        }, {
+          title: "Pro",
+          key: :pro,
+          type: :check,
+        }]
+      }, {
+        rows: [{
+          title: "Sign Up",
+          type: :submit,
+        }]
+      }]
+    })
+
+    @view_controller = Formotion::FormController.alloc.initWithForm(form)
+    @view_controller.form.on_submit do |form|
+        p @view_controller.form.render
+      end
+
+    @window.rootViewController = @view_controller
+    @window.makeKeyAndVisible
+    true
+  end
+end

data/examples/KitchenSink/.gitignore

@@ -0,0 +1,5 @@
+.repl_history
+build
+resources/*.nib
+resources/*.momd
+resources/*.storyboardc

data/examples/KitchenSink/README.md

@@ -0,0 +1,5 @@
+# KitchenSink
+
+Check [app_delegate.rb](https://github.com/clayallsopp/formotion/blob/master/examples/KitchenSink/app/app_delegate.rb) for the code.
+
+![KitchenSink](http://i.imgur.com/fdCfV.png)

data/examples/KitchenSink/Rakefile

@@ -0,0 +1,9 @@
+# -*- coding: utf-8 -*-
+$:.unshift("/Library/RubyMotion/lib")
+require 'motion/project'
+require 'formotion'
+
+Motion::Project::App.setup do |app|
+  # Use `rake config' to see complete project settings.
+  app.name = 'KitchenSink'
+end

data/examples/KitchenSink/app/app_delegate.rb

@@ -0,0 +1,101 @@
+class AppDelegate
+  def application(application, didFinishLaunchingWithOptions:launchOptions)
+    @window = UIWindow.alloc.initWithFrame(UIScreen.mainScreen.bounds)
+
+    @form = Formotion::Form.new({
+      title: "Kitchen Sink",
+      sections: [{
+        title: "Section Title",
+        rows: [{
+          title: "Static",
+          type: :static,
+        }, {
+          title: "Email",
+          key: :email,
+          placeholder: "me@mail.com",
+          type: :email,
+          auto_correction: :no,
+          auto_capitalization: :none
+        }, {
+          title: "Password",
+          key: :password,
+          placeholder: "required",
+          type: :string,
+          secure: true
+        }, {
+          title: "Phone",
+          key: :phone,
+          placeholder: "555-555-5555",
+          type: :phone,
+          auto_correction: :no,
+          auto_capitalization: :none
+        }, {
+          title: "Number",
+          key: :number,
+          placeholder: "12345",
+          type: :number,
+          auto_correction: :no,
+          auto_capitalization: :none
+        }, {
+          title: "Subtitle",
+          subtitle: "Confirmation",
+          key: :confirm,
+          placeholder: "required",
+          type: :string,
+          secure: true
+        }, {
+          title: "Remember?",
+          key: :remember,
+          type: :switch,
+        }]
+      }, {
+        title: "Select One",
+        key: :account_type,
+        select_one: true,
+        rows: [{
+          title: "A",
+          key: :a,
+          type: :check,
+        }, {
+          title: "B (value: true)",
+          value: true,
+          key: :b,
+          type: :check,
+        }, {
+          title: "C",
+          key: :c,
+          type: :check,
+        }]
+      }, {
+        rows: [{
+          title: "Submit",
+          type: :submit,
+        }]
+      }]
+    })
+
+    @navigation_controller = UINavigationController.alloc.init    
+
+    @view_controller = Formotion::FormController.alloc.initWithForm(@form)
+    @view_controller.form.on_submit do |form|
+      alert = UIAlertView.alloc.init
+      alert.title = "@form.render"
+      alert.message = @form.render.to_s
+      alert.addButtonWithTitle("OK")
+      alert.show
+    end
+
+    @view_controller.navigationItem.rightBarButtonItem = UIBarButtonItem.alloc.initWithBarButtonSystemItem(UIBarButtonSystemItemSave, target:self, action:'submit')
+
+    @navigation_controller = UINavigationController.alloc.initWithRootViewController(@view_controller)
+
+    @window.rootViewController = @navigation_controller
+    @window.makeKeyAndVisible
+
+    true
+  end
+
+  def submit
+    @form.submit
+  end
+end

data/examples/KitchenSink/spec/main_spec.rb

@@ -0,0 +1,9 @@
+describe "Application 'KitchenSink'" do
+  before do
+    @app = UIApplication.sharedApplication
+  end
+
+  it "has one window" do
+    @app.windows.size.should == 1
+  end
+end

data/lib/formotion.rb

@@ -0,0 +1,6 @@
+require "formotion/version"
+require 'bubble-wrap/core'
+
+Dir.glob(File.join(File.dirname(__FILE__), 'formotion/**/*.rb')).each do |file|
+  BW.require file
+end

data/lib/formotion/base.rb

@@ -0,0 +1,44 @@
+module Formotion
+  class Base
+    def initialize(params = {})
+      params.each { |key, value|
+        if  self.class.const_get(:PROPERTIES).member? key.to_sym
+          self.send((key.to_s + "=:").to_sym, value)
+        end
+      }
+    end
+
+    def to_hash
+      h = {}
+       self.class.const_get(:PROPERTIES).each { |prop|
+        val = self.send(prop)
+        h[prop] = val if val
+      }
+      h
+    end
+
+    # NSCoding + NSCopying
+    def encodeWithCoder(encoder)
+      self.class.const_get(:SERIALIZE_PROPERTIES).each {|prop|
+        encoder.encodeObject(self.send(prop), forKey: prop.to_s)
+      }
+    end
+  
+    def initWithCoder(decoder)
+      self.init
+      self.class.const_get(:SERIALIZE_PROPERTIES).each {|prop|
+        value = decoder.decodeObjectForKey(prop.to_s)
+        self.send((prop.to_s + "=:").to_sym, value) if not value.nil?
+      }
+      self
+    end
+  
+    def copyWithZone(zone)
+      copy = self.class.allocWithZone(zone).init
+      self.class.const_get(:SERIALIZE_PROPERTIES).each {|prop|
+        copy.send((prop.to_s + "=:").to_sym, self.send(prop))
+      }
+      copy
+    end
+  end
+end