motion-support 0.1.0 → 0.2.0

data/.gitignore

@@ -7,3 +7,6 @@ resources/*.storyboardc
 .bundle
 Gemfile.lock
 pkg/*
+.DS_Store
+doc/*
+.dat*

data/Gemfile

@@ -1,6 +1,6 @@
 source "http://rubygems.org"
 
-gem "bubble-wrap"
+gem 'motion-require'
 
 # Specify your gem's dependencies in motion-support.gemspec
 gemspec

data/README.md

@@ -1,8 +1,237 @@
 # MotionSupport
 
-This is a very small library that sits loosely on top of BubbleWrap to extend the core RubyMotion classes, i.e. no user interface classes. It is somewhat inspired by ActiveSupport, but right now, not a lot is implemented.
+This is a port of the parts of ActiveSupport that make sense for RubyMotion.
 
-To see what's there, look into the lib folder. There is documentation, also most everything is tested.
+To see what's there, generate the documentation with the `rdoc` command from the repository root, or look into the lib folder. Almost everything is tested.
+
+# Usage
+
+Install with
+
+    gem install motion-support
+
+or add to your `Gemfile`
+
+    gem 'motion-support'
+
+# Partial loading
+
+It is also possible to only use parts of this library. To do so, change your `Gemfile` so that it reads:
+
+    gem 'motion-support', :require => false
+
+Then add a require statement as shown below to your `Rakefile`.
+
+## all
+
+    require 'motion-support'
+
+Loads everything.
+
+## inflector
+
+    require 'motion-support/inflector'
+
+Loads the `Inflector` module and extensions to the `String` class. See the "Inflector" app in the `examples/` folder for what the inflector can do.
+
+Example usage include:
+
+    "app_delegate".camelize       # => "AppDelegate"
+    "HomeController".constantize  # => HomeController
+    "thing".pluralize             # => "things"
+    "mice".singularize            # => "mouse"
+
+## core_ext
+
+    require 'motion-support/core_ext'
+
+Loads all the extensions to core classes.
+
+## core_ext/array
+
+    require 'motion-support/core_ext/array'
+
+Loads extensions to class `Array`. Example usage include
+
+    %w( a b c d ).from(2)               # => ["c", "d"]
+    ['one', 'two', 'three'].to_sentence # => "one, two, and three"
+    args.extract_options!               # extracts options hash from variant args array
+    [1, 2, 3, 4].in_groups_of(2)        # => [[1, 2], [3, 4]]
+
+## core_ext/class
+
+    require 'motion-support/core_ext/class'
+
+Loads extensions to class `Class`.
+
+    class Foo
+      cattr_accessor :bar
+      class_attribute :foo
+    end
+
+## core_ext/hash
+
+    require 'motion-support/core_ext/hash'
+
+Loads extensions to class `Hash`, including class `HashWithIndifferentAccess`.
+
+    { 'foo' => 'bar', 'baz' => 'bam' }.symbolize_keys # => { :foo => 'bar', :baz => 'bam' }
+    { 'foo' => 'bar', 'baz' => 'bam' }.except('foo')  # => { 'baz' => 'bam' }
+    { 'foo' => 'bar', 'baz' => 'bam' }.with_indifferent_access
+    # => #<HashWithIndifferentAccess>
+
+## core_ext/integer
+
+    require 'motion-support/core_ext/integer'
+
+Loads extensions to class `Integer`.
+
+    1.ordinalize # => "1st"
+    3.ordinalize # => "3rd"
+
+## core_ext/module
+
+    require 'motion-support/core_ext/module'
+
+Loads extensions to class `Module`.
+
+    module Mod
+      mattr_accessor :foo, :bar
+      attr_internal :baz
+      delegate :boo, :to => :foo
+      
+      remove_method :baz
+    end
+
+## core_ext/numeric
+
+    require 'motion-support/core_ext/numeric'
+
+Loads extensions to class `Numeric`.
+
+    10.kilobytes  # => 10240
+    2.megabytes   # => 2097152
+    3.days
+
+## core_ext/object
+
+    require 'motion-support/core_ext/object'
+
+Loads extensions to class `Object`.
+
+    nil.blank?                                      # => true
+    Object.new.blank?                               # => false
+    { "hello" => "world", "foo" => "bar" }.to_query # => "hello=world&foo=bar"
+    1.duplicable?                                   # => false
+    1.try(:to_s)                                    # => "1"
+    nil.try(:to_s)                                  # => nil
+
+## core_ext/range
+
+    require 'motion-support/core_ext/range'
+
+Loads extensions to class `Range`.
+
+    (1..5).overlaps(3..9) # => true
+    (1..5).include?(2..3) # => true
+
+## core_ext/string
+
+    require 'motion-support/core_ext/string'
+
+Loads extensions to class `String`.
+
+    "ruby_motion".camelize    # => "RubyMotion"
+    "User".pluralize          # => "Users"
+    "mice".singularize        # => "mouse"
+    "Foo::Bar".underscore     # => "foo/bar"
+    "AppDelegate".underscore  # => "app_delegate"
+    "UIView".constantize      # => UIView
+
+## core_ext/time
+
+    require 'motion-support/core_ext/time'
+
+Loads extensions to class `Time`.
+
+    1.week.ago
+    17.days.from_now
+    Date.yesterday
+    Time.beginning_of_week
+
+# Differences to ActiveSupport
+
+In general:
+
+* All `I18n` stuff was removed. Maybe it will be readded later.
+* No support for the `TimeWithZone` class (iOS apps don't need advanced time zone support)
+* No support for the `DateTime` class
+* All deprecated methods have been removed
+* All `YAML` extensions were removed, since RubyMotion doesn't come with YAML support
+* `Kernel#silence_warnings` and stream manipulation methods were removed
+* Multibyte string handling methods have been removed
+* All Rails-specific stuff was removed
+* The dependency resolution code was removed. So was the dynamic code reloading code
+* All marshalling code was removed
+* All logging code was removed
+* All extensions to `Test::Unit` were removed
+
+Specifically:
+
+* `Array#third` .. `Array#fourty_two` were removed
+* `Array#to_xml` is missing
+* `Array#to_sentence` does not accept a `:locale` parameter
+* `Class#subclasses` is missing. It depends on `ObjectSpace.each_object` which is missing in RubyMotion
+* `Hash#extractable_options?` is missing
+* `BigDecimal` conversions were removed
+* `Time.current` an alias for `Time.now`
+* `Date.current` an alias for `Date.today`
+* `Date#to_time` does not accept a timezone form (`:local`, `:utc`)
+* `Date#xmlschema` is missing
+* `Object#in?` is missing. It is incompatible with Bacon, it will break specs.
+* `String#parameterize` is missing because it needs to transliterate the string, which is dependent on the locale
+* `String#constantize` is very slow. Cache the result if you use it.
+* `String#to_time`, `#to_date`, `#to_datetime` are missing because they depend on `Date#_parse`
+* String inquiry methods are missing
+* String multibyte methods are missing
+* `String#html_safe` and `ERB` extensions are not needed in RubyMotion
+* `Object#to_json` and subclasses are missing
+* `Range#to_s(:db)` was removed
+* The `rfc822` time format was removed, since it relies on time zone support.
+* Extensions to `LoadError` and `NameError` were removed
+* The `ThreadSafe` versions of `Hash` and `Array` are just aliases to the standard classes
+
+Things to do / to decide:
+
+* RubyMotion lacks a `Date` class. in `_stdlib` there is a stub of a Date class that makes the `Date` extensions work. This stub needs to be completed.
+* Implement `Object#to_json`, probably best if implemented on top of Cocoa APIs
+* Implement `Object#to_xml`
+* Implement `Hash#from_xml`
+* Do we need `Hash#extractable_options?`?
+* Do we need `Class#superclass_delegating_accessor`?
+* Implement all `InfiniteComparable` extensions
+* Do we need `File#atomic_write` for thread-safe file writing?
+* Do we need `Kernel#class_eval` (it delegates to `class_eval` on this' singleton class)?
+* Do we need `Module#qualified_const_defined?`? What is that even for?
+* Do we need `Module#synchronize`?
+* Implement `Numeric` conversions, especially `NumberHelper`
+* Do we need `Object#with_options`?
+* Implement `String#to_time`, `String#to_date`. In the original ActiveSupport, they make use of the `Date#_parse` method (which seems like it's supposed to be private). Here, they should be implemented on top of Cocoa APIs
+* Do we need `String#parameterize`? If so, we need to find a way to transliterate UTF-8 characters.
+* Do we need the `StringInquirer`? It allows things like `Rails.env.development?` instead of `Rails.env == 'development'`
+* Do we need multibyte string handling extensions? AFAIK, all strings in RubyMotion are UTF-8. Is that true?
+* Do we need `Struct#to_h`?
+* Implement extensions to class `Thread` if they make sense.
+* Port callbacks.rb
+* Port concern.rb
+* Do we need the `Configurable` module?
+* Do we need the `DescendantsTracker` module?
+* Do we need the `OrderedOptions` class?
+* Go through documentation and remove or rewrite things not relevant to RubyMotion, especially examples mentioning Rails components
+
+# Acknowledgements
+
+ActiveSupport was originally written as part of Ruby on Rails by David Heinemeier Hansson. Over the years, countless contributors made many additions. They made this library possible.
 
 # Forking
 

data/Rakefile

@@ -5,10 +5,10 @@ require "bundler/gem_tasks"
 Bundler.setup
 Bundler.require
 
-$:.unshift("./lib/")
-require './lib/motion-support'
+require 'motion-support'
 
 Motion::Project::App.setup do |app|
   # Use `rake config' to see complete project settings.
   app.name = 'MotionSupport'
-end
+  app.detect_dependencies = false
+end

data/app/app_delegate.rb

@@ -1,7 +1,5 @@
 class AppDelegate
   def application(application, didFinishLaunchingWithOptions:launchOptions)
-    @window = UIWindow.alloc.initWithFrame(UIScreen.mainScreen.bounds)
-    @window.rootViewController = UIViewController.alloc.init
     true
   end
 end

data/examples/Inflector/.gitignore

@@ -0,0 +1,16 @@
+.repl_history
+build
+tags
+app/pixate_code.rb
+resources/*.nib
+resources/*.momd
+resources/*.storyboardc
+.DS_Store
+nbproject
+.redcar
+#*#
+*~
+*.sw[po]
+.eprj
+.sass-cache
+.idea

data/examples/Inflector/Gemfile

@@ -0,0 +1,5 @@
+source "http://rubygems.org"
+
+gem 'rake'
+gem 'motion-require'
+gem 'formotion'

data/examples/Inflector/Rakefile

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

data/examples/Inflector/app/app_delegate.rb

@@ -0,0 +1,8 @@
+class AppDelegate
+  def application(application, didFinishLaunchingWithOptions:launchOptions)
+    @window = UIWindow.alloc.initWithFrame(UIScreen.mainScreen.bounds)
+    @window.rootViewController = UINavigationController.alloc.initWithRootViewController(InflectorViewController.alloc.init)
+    @window.makeKeyAndVisible
+    true
+  end
+end

data/examples/Inflector/app/inflections.rb

@@ -0,0 +1,5 @@
+MotionSupport::Inflector.inflections do |inflect|
+  inflect.acronym 'HTML'
+  inflect.acronym 'API'
+  inflect.acronym 'BSD'
+end

data/examples/Inflector/app/inflector_view_controller.rb

@@ -0,0 +1,120 @@
+class Formotion::Form
+  def row(key)
+    sections.each do |section|
+      section.rows.each do |row|
+        return row if row.key == key
+      end
+    end
+    nil
+  end
+end
+
+class InflectorViewController < Formotion::FormController
+  def init
+    initWithForm(build_form)
+    self.title = "Inflector"
+    @form.on_submit do |form|
+      submit(form)
+    end
+    self
+  end
+  
+  def submit(form)
+    data = form.render
+    original = String.new(data[:word])
+    
+    update_fields(original)
+    
+    form.row(:word).text_field.resignFirstResponder
+  end
+  
+  def set_word(word)
+    @form.values = { :word => word }
+    update_fields(word)
+  end
+  
+  def update_fields(original)
+    @form.values = {
+      :singular => original.singularize,
+      :plural => original.pluralize,
+      :camelized => original.camelize,
+      :lower_camelized => original.camelize(:lower),
+      :underscored => original.underscore,
+      :classified => original.classify,
+      :dasherized => original.dasherize,
+      :titleized => original.titleize,
+      :humanized => original.humanize
+    }
+  end
+
+private
+  def build_form
+    @form ||= Formotion::Form.persist({
+      sections: [{
+        rows: [{
+          title: "Word",
+          key: :word,
+          type: :string,
+          placeholder: "Enter a word",
+          auto_correction: :no,
+          auto_capitalization: :none
+        }, {
+          title: "Select",
+          type: :button,
+          key: :select
+        }]
+      }, {
+        rows: [{
+          title: "Inflect",
+          type: :submit
+        }]
+      }, {
+        title: "Inflections",
+        rows: [{
+          title: "Singular",
+          key: :singular,
+          type: :static
+        }, {
+          title: "Plural",
+          key: :plural,
+          type: :static
+        }]
+      }, {
+        title: "Transformations",
+        rows: [{
+          title: "Camelized",
+          key: :camelized,
+          type: :static
+        }, {
+          title: "Lower-Camelized",
+          key: :lower_camelized,
+          type: :static
+        }, {
+          title: "Underscored",
+          key: :underscored,
+          type: :static
+        }, {
+          title: "Classified",
+          key: :classified,
+          type: :static
+        }, {
+          title: "Dasherized",
+          key: :dasherized,
+          type: :static
+        }, {
+          title: "Titleized",
+          key: :titleized,
+          type: :static
+        }, {
+          title: "Humanized",
+          key: :humanized,
+          type: :static
+        }]
+      }]
+    })
+    @form.row(:select).on_tap do
+      self.navigationController.pushViewController(WordsViewController.alloc.initWithParent(self), animated:true)
+    end
+    @form
+  end
+end

data/examples/Inflector/app/words_view_controller.rb

@@ -0,0 +1,101 @@
+class WordsViewController < UITableViewController
+  WORDS = [
+    [
+      "Single words",
+      %w{
+        alias
+        axis
+        buffalo
+        bus
+        cat
+        child
+        cow
+        crisis
+        dog
+        house
+        man
+        matrix
+        mouse
+        move
+        octopus
+        ox
+        parenthesis
+        person
+        quiz
+        series
+        sex
+        vertex
+        zombie
+      }
+    ], [
+      "Uncountable words",
+      %w{
+        equipment
+        fish
+        information
+        jeans
+        money
+        police
+        rice
+        series
+        sheep
+        species
+      }
+    ], [
+      "Programming",
+      %w{
+        app_delegate
+        motion_support
+        motion_support/inflector
+        ruby_motion
+      }
+    ], [
+      "Acronyms",
+      %w{
+        free_bsd
+        html_api
+        html_tidy
+        ui_image
+        ui_table_view_controller
+        xml_http_request
+      }
+    ]
+  ]
+  
+  def initWithParent(parent)
+    @parent = parent
+    
+    self.title = "Select word"
+    
+    self
+  end
+  
+  def numberOfSectionsInTableView(tableView)
+    WORDS.size
+  end
+  
+  def tableView(tableView, titleForHeaderInSection:section)
+    WORDS[section].first
+  end
+  
+  def tableView(tableView, numberOfRowsInSection:section)
+    WORDS[section].last.size
+  end
+
+  def tableView(tableView, cellForRowAtIndexPath:indexPath)
+    fresh_cell.tap do |cell|
+      cell.textLabel.text = WORDS[indexPath.section].last[indexPath.row]
+    end
+  end
+  
+  def tableView(tableView, didSelectRowAtIndexPath:indexPath)
+    @parent.set_word(WORDS[indexPath.section].last[indexPath.row])
+    navigationController.popViewControllerAnimated(true)
+  end
+  
+private
+  def fresh_cell
+    tableView.dequeueReusableCellWithIdentifier('Cell') ||
+    UITableViewCell.alloc.initWithStyle(UITableViewCellStyleSubtitle, reuseIdentifier:'Cell')
+  end
+end

data/examples/Inflector/spec/main_spec.rb

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

data/lib/motion-support/core_ext/array.rb

@@ -0,0 +1,13 @@
+require 'motion-require'
+
+files = [
+  'core_ext/array',
+  'core_ext/array/wrap',
+  'core_ext/array/access',
+  'core_ext/array/conversions',
+  'core_ext/array/extract_options',
+  'core_ext/array/grouping',
+  'core_ext/array/prepend_and_append'
+].map { |file| File.expand_path(File.join(File.dirname(__FILE__), "/../../../motion", "#{file}.rb")) }
+
+Motion::Require.all(files)

data/lib/motion-support/core_ext/class.rb

@@ -0,0 +1,8 @@
+require 'motion-require'
+
+files = [
+  'core_ext/class/attribute',
+  'core_ext/class/attribute_accessors',
+].map { |file| File.expand_path(File.join(File.dirname(__FILE__), "/../../../motion", "#{file}.rb")) }
+
+Motion::Require.all(files)

data/lib/motion-support/core_ext/hash.rb

@@ -0,0 +1,16 @@
+require 'motion-require'
+
+files = [
+  'core_ext/ns_dictionary',
+  'core_ext/hash/deep_merge',
+  'core_ext/hash/except',
+  'core_ext/hash/indifferent_access',
+  'core_ext/hash/keys',
+  'core_ext/hash/reverse_merge',
+  'core_ext/hash/slice',
+  'hash_with_indifferent_access',
+  
+  'core_ext/module/delegation'
+].map { |file| File.expand_path(File.join(File.dirname(__FILE__), "/../../../motion", "#{file}.rb")) }
+
+Motion::Require.all(files)

data/lib/motion-support/core_ext/integer.rb

@@ -0,0 +1,9 @@
+require 'motion-require'
+
+files = [
+  'core_ext/integer/multiple',
+  'core_ext/integer/inflections',
+  'core_ext/integer/time'
+].map { |file| File.expand_path(File.join(File.dirname(__FILE__), "/../../../motion", "#{file}.rb")) }
+
+Motion::Require.all(files)

data/lib/motion-support/core_ext/module.rb

@@ -0,0 +1,14 @@
+require 'motion-require'
+
+files = [
+  'core_ext/module/aliasing',
+  'core_ext/module/introspection',
+  'core_ext/module/anonymous',
+  'core_ext/module/reachable',
+  'core_ext/module/attribute_accessors',
+  'core_ext/module/attr_internal',
+  'core_ext/module/delegation',
+  'core_ext/module/remove_method'
+].map { |file| File.expand_path(File.join(File.dirname(__FILE__), "/../../../motion", "#{file}.rb")) }
+
+Motion::Require.all(files)

data/lib/motion-support/core_ext/numeric.rb

@@ -0,0 +1,8 @@
+require 'motion-require'
+
+files = [
+  'core_ext/numeric/bytes',
+  'core_ext/numeric/time'
+].map { |file| File.expand_path(File.join(File.dirname(__FILE__), "/../../../motion", "#{file}.rb")) }
+
+Motion::Require.all(files)

data/lib/motion-support/core_ext/object.rb

@@ -0,0 +1,14 @@
+require 'motion-require'
+
+files = [
+  'core_ext/object/acts_like',
+  'core_ext/object/blank',
+  'core_ext/object/deep_dup',
+  'core_ext/object/duplicable',
+  'core_ext/object/try',
+  'core_ext/object/instance_variables',
+  'core_ext/object/to_param',
+  'core_ext/object/to_query',
+].map { |file| File.expand_path(File.join(File.dirname(__FILE__), "/../../../motion", "#{file}.rb")) }
+
+Motion::Require.all(files)

data/lib/motion-support/core_ext/range.rb

@@ -0,0 +1,8 @@
+require 'motion-require'
+
+files = [
+  'core_ext/range/include_range',
+  'core_ext/range/overlaps'
+].map { |file| File.expand_path(File.join(File.dirname(__FILE__), "/../../../motion", "#{file}.rb")) }
+
+Motion::Require.all(files)

data/lib/motion-support/core_ext/string.rb

@@ -0,0 +1,14 @@
+require 'motion-require'
+
+files = [
+  'core_ext/string/access',
+  'core_ext/string/behavior',
+  'core_ext/string/exclude',
+  'core_ext/string/filters',
+  'core_ext/string/indent',
+  'core_ext/string/starts_ends_with',
+  'core_ext/string/inflections',
+  'core_ext/string/strip'
+].map { |file| File.expand_path(File.join(File.dirname(__FILE__), "/../../../motion", "#{file}.rb")) }
+
+Motion::Require.all(files)