motion-resource 0.0.1

data/.gitignore

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

data/Gemfile

@@ -0,0 +1,8 @@
+source "http://rubygems.org"
+
+gem "bubble-wrap"
+gem "motion-support"
+gem "webstub", :git => 'git://github.com/mattgreen/webstub.git'
+
+# Specify your gem's dependencies in motion-support.gemspec
+gemspec

data/README.md

@@ -0,0 +1,53 @@
+# MotionResource
+
+This is a library for using JSON APIs in RubyMotion apps. It is based on [RemoteModel](https://github.com/clayallsopp/remote_model), however it is an almost complete rewrite. Also, it is inspired by ActiveResource.
+
+## Installation
+
+Add MotionResource to your Gemfile, like this:
+
+    gem "motion-resource"
+
+## Example
+
+Consider this example for a fictional blog API.
+
+    class User < RemoteModule::RemoteModel
+      attr_accessor :id
+
+      has_many :posts
+
+      collection_url "users"
+      member_url "users/:id"
+    end
+
+    class Post < RemoteModule::RemoteModel
+      attr_accessor :id, :user_id, :title, :text
+
+      belongs_to :user
+
+      collection_url "users/:user_id/posts"
+      member_url "users/:user_id/posts/:id"
+    end
+
+Now, we can access a user's posts like that:
+
+    User.find(1) do |user|
+      user.posts do |posts|
+        puts posts.inspect
+      end
+    end
+
+Note that the blocks are called asynchronously.
+
+## Setup
+
+You can configure every model separately; however you will most likely want to configure things like the root_url the same for every model:
+
+    MotionResource::Base.root_url = "http://localhost:3000/"
+
+Don't forget the trailing '/' here!
+
+# Forking
+
+Feel free to fork and submit pull requests!

data/Rakefile

@@ -0,0 +1,14 @@
+#!/usr/bin/env rake
+$:.unshift("/Library/RubyMotion/lib")
+require 'motion/project'
+require "bundler/gem_tasks"
+Bundler.setup
+Bundler.require
+
+$:.unshift("./lib/")
+require './lib/motion-resource'
+
+Motion::Project::App.setup do |app|
+  # Use `rake config' to see complete project settings.
+  app.name = 'MotionResource'
+end

data/app/app_delegate.rb

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

data/examples/Colr/.gitignore

@@ -0,0 +1,13 @@
+.repl_history
+build
+tags
+resources/*.nib
+resources/*.momd
+resources/*.storyboardc
+.DS_Store
+nbproject
+.redcar
+#*#
+*~
+*.sw[po]
+.eprj

data/examples/Colr/Rakefile

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

data/examples/Colr/app/app_delegate.rb

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

data/examples/Colr/app/color.rb

@@ -0,0 +1,15 @@
+class Color < MotionResource::Base
+  attr_accessor :hex
+  
+  has_many :tags
+  
+  scope :random, :url => 'json/colors/random/7'
+  
+  def ui_color
+    pointer = Pointer.new(:uint)
+    scanner = NSScanner.scannerWithString(self.hex)
+    scanner.scanHexInt(pointer)
+    rgbValue = pointer[0]
+    return UIColor.colorWithRed(((rgbValue & 0xFF0000) >> 16)/255.0, green:((rgbValue & 0xFF00) >> 8)/255.0, blue:(rgbValue & 0xFF)/255.0, alpha:1.0)
+  end
+end

data/examples/Colr/app/color_view_controller.rb

@@ -0,0 +1,46 @@
+class ColorViewController < UITableViewController
+  attr_accessor :colors
+  
+  def init
+    self.colors = []
+    self.title = "7 random colors"
+    super
+  end
+  
+  def viewDidLoad
+    load_data
+    super
+  end
+  
+  def tableView(tableView, numberOfRowsInSection:section)
+    self.colors.size
+  end
+  
+  def tableView(tableView, cellForRowAtIndexPath:indexPath)
+    cell = tableView.dequeueReusableCellWithIdentifier('Cell')
+    cell ||= UITableViewCell.alloc.initWithStyle(UITableViewCellStyleSubtitle, reuseIdentifier:'Cell')
+    
+    color = colors[indexPath.row]
+    cell.textLabel.text = color.hex
+    cell.accessoryType = UITableViewCellAccessoryDisclosureIndicator
+    cell
+  end
+  
+  def tableView(tableView, willDisplayCell:cell, forRowAtIndexPath:indexPath)
+    color = colors[indexPath.row]
+    cell.backgroundColor = color.ui_color
+  end
+  
+  def tableView(tableView, didSelectRowAtIndexPath:indexPath)
+    navigationController.pushViewController(TagsViewController.alloc.initWithColor(colors[indexPath.row]), animated:true)
+  end
+  
+  def load_data
+    Color.random do |results|
+      if results
+        self.colors = results
+      end
+      tableView.reloadData
+    end
+  end
+end

data/examples/Colr/app/initializer.rb

@@ -0,0 +1,2 @@
+MotionResource::Base.root_url = 'http://www.colr.org/'
+MotionResource::Base.extension = ''

data/examples/Colr/app/main_navigation_controller.rb

@@ -0,0 +1,6 @@
+class MainNavigationController < UINavigationController
+  def init
+    initWithRootViewController(ColorViewController.alloc.init)
+    self
+  end
+end

data/examples/Colr/app/tag.rb

@@ -0,0 +1,5 @@
+class Tag < MotionResource::Base
+  attr_accessor :name
+  
+  belongs_to :color
+end

data/examples/Colr/app/tags_view_controller.rb

@@ -0,0 +1,23 @@
+class TagsViewController < UITableViewController
+  attr_accessor :color
+  
+  def initWithColor(color)
+    self.color = color
+    self.title = "Tags for color #{color.hex}"
+    init
+  end
+  
+  def tableView(tableView, numberOfRowsInSection:section)
+    self.color.tags.size
+  end
+  
+  def tableView(tableView, cellForRowAtIndexPath:indexPath)
+    cell = tableView.dequeueReusableCellWithIdentifier('Cell')
+    cell ||= UITableViewCell.alloc.initWithStyle(UITableViewCellStyleSubtitle, reuseIdentifier:'Cell')
+    
+    tag = color.tags[indexPath.row]
+    cell.textLabel.text = tag.name
+    cell.selectionStyle = UITableViewCellSelectionStyleNone
+    cell
+  end
+end

data/lib/motion-resource.rb

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

data/lib/motion-resource/associations.rb

@@ -0,0 +1,94 @@
+module MotionResource
+  class Base
+    class << self
+      def has_one(name)
+        define_method name do
+          instance_variable_get("@#{name}")
+        end
+        
+        define_method "#{name}=" do |value|
+          klass = Object.const_get(name.to_s.classify)
+          value = klass.instantiate(value) if value.is_a?(Hash)
+          instance_variable_set("@#{name}", value)
+        end
+        
+        define_method "reset_#{name}" do
+          instance_variable_set("@#{name}", nil)
+        end
+      end
+
+      def has_many(name, params = lambda { |o| Hash.new })
+        backwards_association = self.name.underscore
+        
+        define_method name do |&block|
+          if block.nil?
+            instance_variable_get("@#{name}") || []
+          else
+            cached = instance_variable_get("@#{name}")
+            block.call(cached) and return if cached
+            
+            Object.const_get(name.to_s.classify).find_all(params.call(self)) do |results|
+              if results && results.first && results.first.respond_to?("#{backwards_association}=")
+                results.each do |result|
+                  result.send("#{backwards_association}=", self)
+                end
+              end
+              instance_variable_set("@#{name}", results)
+              block.call(results)
+            end
+          end
+        end
+        
+        define_method "#{name}=" do |array|
+          klass = Object.const_get(name.to_s.classify)
+          instance_variable_set("@#{name}", [])
+          
+          array.each do |value|
+            value = klass.instantiate(value) if value.is_a?(Hash)
+            instance_variable_get("@#{name}") << value
+          end
+        end
+        
+        define_method "reset_#{name}" do
+          instance_variable_set("@#{name}", nil)
+        end
+      end
+
+      def belongs_to(name, params = lambda { |o| Hash.new })
+        define_method name do |&block|
+          if block.nil?
+            instance_variable_get("@#{name}")
+          else
+            cached = instance_variable_get("@#{name}")
+            block.call(cached) and return if cached
+          
+            Object.const_get(name.to_s.classify).find(self.send("#{name}_id"), params.call(self)) do |result|
+              instance_variable_set("@#{name}", result)
+              block.call(result)
+            end
+          end
+        end
+        
+        define_method "#{name}=" do |value|
+          klass = Object.const_get(name.to_s.classify)
+          value = klass.instantiate(value) if value.is_a?(Hash)
+          instance_variable_set("@#{name}", value)
+        end
+        
+        define_method "reset_#{name}" do
+          instance_variable_set("@#{name}", nil)
+        end
+      end
+    end
+
+    class << self
+      def scope(name, options = {})
+        custom_urls "#{name}_url" => options[:url] if options[:url]
+        
+        metaclass.send(:define_method, name) do |&block|
+          fetch_collection(send("#{name}_url"), &block)
+        end
+      end
+    end
+  end
+end

data/lib/motion-resource/attributes.rb

@@ -0,0 +1,37 @@
+module MotionResource
+  class Base
+    class_inheritable_array :attributes
+    
+    class << self
+      def attribute(*fields)
+        attr_reader *fields
+        fields.each do |field|
+          define_method "#{field}=" do |value|
+            if value.is_a?(Hash) || value.is_a?(Array)
+              instance_variable_set("@#{field}", value.dup)
+            else
+              instance_variable_set("@#{field}", value)
+            end
+          end
+        end
+        self.attributes += fields
+      end
+    end
+    
+    def update_attributes(params = {})
+      attributes = self.methods - Object.methods
+      params.each do |key, value|
+        if attributes.member?((key.to_s + "=:").to_sym)
+          self.send((key.to_s + "=:").to_sym, value)
+        end
+      end
+    end
+    
+    def attributes
+      self.class.attributes.inject({}) do |hash, attr|
+        hash[attr] = send(attr)
+        hash
+      end
+    end
+  end
+end

data/lib/motion-resource/base.rb

@@ -0,0 +1,51 @@
+module MotionResource
+  class Base
+    attr_accessor :id
+    
+    def initialize(params = {})
+      @new_record = true
+      update_attributes(params)
+    end
+    
+    def new_record?
+      @new_record
+    end
+    
+    class << self
+      def instantiate(json)
+        raise ArgumentError, "No :id parameter given for #{self.name}.instantiate" unless json[:id]
+        
+        klass = if json[:type]
+          begin
+            Object.const_get(json[:type].to_s)
+          rescue NameError
+            self
+          end
+        else
+          self
+        end
+        
+        if result = klass.recall(json[:id])
+          result.update_attributes(json)
+        else
+          result = klass.new(json)
+          klass.remember(result.id, result)
+        end
+        result.send(:instance_variable_set, "@new_record", false)
+        result
+      end
+      
+      def identity_map
+        @identity_map ||= {}
+      end
+      
+      def remember(id, value)
+        identity_map[id] = value
+      end
+      
+      def recall(id)
+        identity_map[id]
+      end
+    end
+  end
+end

data/lib/motion-resource/crud.rb

@@ -0,0 +1,33 @@
+module MotionResource
+  class Base
+    def save(&block)
+      @new_record ? create(&block) : update(&block)
+    end
+    
+    def update(&block)
+      self.class.put(member_url, :payload => { self.class.name.underscore => attributes }) do |response, json|
+        block.call json.blank? ? nil : self.class.instantiate(json) if block
+      end
+    end
+  
+    def create(&block)
+      # weird heisenbug: Specs crash without that line :(
+      dummy = self
+      self.class.post(collection_url, :payload => { self.class.name.underscore => attributes }) do |response, json|
+        block.call json.blank? ? nil : self.class.instantiate(json) if block
+      end
+    end
+  
+    def destroy(&block)
+      self.class.delete(member_url) do |response, json|
+        block.call json.blank? ? nil : self.class.instantiate(json) if block
+      end
+    end
+    
+    def reload(&block)
+      self.class.get(member_url) do |response, json|
+        block.call json.blank? ? nil : self.class.instantiate(json) if block
+      end
+    end
+  end
+end