meteor-motion 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: a15bd2d5261b5c3cd00cf2892d0cb31e4fb3c72f
+  data.tar.gz: cb93ae359474741e4d91781d56b353a762345e99
+SHA512:
+  metadata.gz: 843330aa37a6cd2c95e903258bb199a75cdd5e75b97d344af3a89ac1c26dae39a5e2a9f98b25d2dd212458fc8de86fb105561065fceaf9d3f95ce1dc67aaaad2
+  data.tar.gz: 4d9c4a63b4ecb45c8456348a87e1a6154192ede3437209576a8101cda88c9fd4f0df270125558254854e5d90ea7097035ebc92a902e82f1ece68c3a3897447ac

data/.gitignore

@@ -0,0 +1,21 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+build
+private-docs
+vendor/**/build*
+**/.DS_Store

data/Gemfile

@@ -0,0 +1,6 @@
+source 'https://rubygems.org'
+
+gem 'rm-digest', git: 'git://github.com/tmeinlschmidt/rm-digest.git'
+gem 'formotion'
+# Specify your gem's dependencies in meteor-motion.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 TODO: Write your name
+
+MIT License
+
+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.md

@@ -0,0 +1,166 @@
+# MeteorMotion
+
+Rubymotion Wrapper for communication with Meteor apps via DDP, with SRP authentication capabilities.
+
+## Installation
+
+If using Bundler, add to your application's Gemfile:
+
+    gem 'meteor-motion'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install meteor-motion
+    
+And in your application's Rakefile add:
+
+```ruby
+require 'meteor-motion'
+```
+
+## Usage
+
+### Initialization
+
+Create a new MeteorMotion client and connect to your Meteor app:
+
+```ruby
+client = MeteorMotion::Client.new
+client.connect('localhost', 3000, self.method(:on_connect) )
+
+def on_connect status
+    # Handler for the connection attempt - optional
+    # status - either true or false
+end
+
+def error_handler code, reason, details
+    # Handler for general connection errors, malformed messages and failed subscriptions
+end
+
+client.on_error( self.method(:error_handler) )
+```
+
+By default, it will expand the hostname to ```http://hostname:port/websocket``` per the current Meteor specifications.
+
+### Collections and subscriptions
+
+In order to receive data, you need to first create a local collection to handle the data. You should add an observer to this collection, that will be called whenever the data in the collection is changed.
+
+```ruby
+def collection_handler action, id
+    # action - will be one of [:added, :changed, :removed]
+    # id - the id of the element of the collection affected
+end
+
+collection = client.add_collection('collection_name')
+collection.add_observer( self.method(:collection_handler) )
+```
+
+To remove an observer, simply call ```collection.remove_observer( method )```. With a collection setup, you can subscribe/unsubscribe to data published on the server with:
+
+```ruby
+client.subscribe('subscription_name', params)
+client.unsubscribe('subscription_name')
+```
+
+When there is data available, you can access objects on the collection:
+
+```ruby
+object = collection.find(id)
+att1 = object['att1']
+att2 = object['att2']
+```
+
+### Model Adapters
+Meteor-Motion supports, for the time being, and adapter to be used with the [MotionModel gem](https://github.com/sxross/MotionModel). After installing it, simply define your model classes as such:
+
+```ruby
+class Objects
+    include MotionModel::Model
+    include MotionModel::ArrayModelAdapter
+    include MeteorMotion::Adapters::MotionModel
+
+    columns :id, :string
+    #...
+end
+
+client.add_collection(Objects, name='objects')
+
+```
+
+The ```id```column is mandatory, so that MeteorMotion does not auto-generate and id column with an integer type, which is incompatible with Meteor standard. Also, take care that if you ommit the ```name``` parameter when adding the collection, the collection name will default to the downcased name of your class. After this setup, enjoy MotionModel as usual.
+
+### Method calls
+
+```ruby
+def method_callback action, result
+    # action - one of the following [:result, :updated, :error]
+    # result - either the return value of the method (when action == :result) 
+    #          or error details (when action == :error)
+end
+
+client.call('some_method_name', self.method(:method_callback), params)
+```
+
+### Authentication
+
+Right now, MeteorMotion provides support for authentication using Meteor's built-in SRP. To authenticate with a username/password combination use the following:
+
+```ruby
+def login_handler action, details
+    # action - either :success or :error
+    # details - nil on :success, Hash with error details on :error 
+end
+
+client.login_with_username('username', 'password', self.method(:login_handler))
+```
+
+## Testing
+
+To run tests first start-up the included sample Meteor app:
+
+```bash
+cd spec/server
+meteor run
+```
+
+Then run the tests with rake:
+
+```bash
+rake spec
+```
+
+### Example app
+
+You can find a working example in the ```app``` directory. Remember to run the meteor server prior to starting the application. To login, use the credentials ```user/pass```. To run the application in the simulator simply run:
+
+```bash
+rake
+```
+
+## Credits
+### Developed by
+<a href="http://whitesmith.co/">
+    <img src="http://www.whitesmith.co/assets/logo-whitesmith-4109176a79f86b9ca4b8022d6dcab3bb.png" alt="http://whitesmith.co/" height=100px />
+</a>
+
+Lead Developer: [mtavaresOS](https://github.com/mtavaresOS)
+
+### Sponsored by
+<a href="http://www.revokom.com/">
+    <img src="http://www.revokom.com/img/logo_banner.png" alt="http://www.revokom.com/"/>
+</a>
+
+
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,17 @@
+#!/usr/bin/env rake
+$:.unshift("/Library/RubyMotion/lib")
+require 'motion/project/template/ios'
+require 'bundler/gem_tasks'
+require 'bubble-wrap/test'
+require 'bubble-wrap/core'
+require 'motion_model'
+require 'motion-redgreen'
+Bundler.setup
+Bundler.require
+
+Motion::Project::App.setup do |app|
+  # Use `rake config' to see complete project settings.
+  app.name = 'MeteorMotion Example'
+  app.delegate_class = "AppDelegate"
+  app.redgreen_style = :full
+end

data/app/app_delegate.rb

@@ -0,0 +1,11 @@
+class AppDelegate
+  def application(application, didFinishLaunchingWithOptions:launchOptions)
+    @window = UIWindow.alloc.initWithFrame(UIScreen.mainScreen.bounds)
+  	@window.makeKeyAndVisible
+
+  	@window.rootViewController = ConnectionController.alloc.initWithNibName(nil, bundle: nil)
+
+  	true
+  end
+
+end

data/app/controllers/book_controller.rb

@@ -0,0 +1,92 @@
+class BookController < Formotion::FormController
+	attr_accessor :meteor, :_id
+
+	def viewDidLoad
+		super
+		self.title = "Details"
+	end
+
+	def viewWillAppear animated
+		super
+		@books = @meteor.collections['books']
+    @books.add_observer( self.method(:update_form) )
+
+    self.form.on_submit do |form|
+			data = form.render
+			self.view.endEditing(true)
+
+			if @_id != nil
+				@meteor.call('/books/update', self.method(:handle_update), [{_id: @_id},{title: data[:title], author: data[:author],year: data[:year]}])
+			else
+				new_id = SecureRandom.hex
+				@meteor.call('/books/insert', self.method(:handle_update), [{_id: new_id,title: data[:title], author: data[:author],year: data[:year]}])
+			end
+
+		end
+
+		if @_id != nil
+			right_button = UIBarButtonItem.alloc.initWithTitle("Remove", style: UIBarButtonItemStyleDone, target:self, action:'remove')
+	  	self.navigationItem.rightBarButtonItem = right_button
+	  end
+  end
+
+	def viewWillDisappear animated
+		super
+		@books.remove_observer( self.method(:update_form) )
+	end
+
+
+	def update_form action, id
+		if id == @_id
+			if action == :removed
+				self.navigationController.popViewControllerAnimated(true)
+			elsif action == :changed
+				book = @books.find(id)
+				self.form.row(:title).value = book['title']
+				self.form.row(:author).value = book['author']
+				self.form.row(:year).value = book['year']
+			end
+		end
+	end
+
+	def handle_update action, result
+		if action == :error
+			alert = UIAlertView.new
+  		alert.message = "Error: #{result['reason'].to_s}"
+  		alert.addButtonWithTitle "OK"
+  		alert.show
+		elsif action == :result
+			alert = UIAlertView.new
+			if @_id != nil
+  			alert.message = "Book updated sucessfully"
+  			alert.addButtonWithTitle "OK"
+  			alert.show	
+  		else
+  			alert.message = "Book added sucessfully"
+  			alert.addButtonWithTitle "OK"
+  			alert.show	
+  			self.navigationController.popViewControllerAnimated(true)
+  		end
+		end
+	end
+
+	def handle_remove action, result
+		if action == :error
+			alert = UIAlertView.new
+  		alert.message = "Error: #{result['reason'].to_s}"
+  		alert.addButtonWithTitle "OK"
+  		alert.show
+		elsif action == :result
+			alert = UIAlertView.new
+  		alert.message = "Book removed sucessfully"
+  		alert.addButtonWithTitle "OK"
+  		alert.show
+		end
+	end
+
+
+	def remove
+		@meteor.call('/books/remove', self.method(:handle_remove), [{_id: @_id}])
+	end
+
+end

data/app/controllers/book_list_controller.rb

@@ -0,0 +1,105 @@
+class BookListController < UIViewController
+	attr_accessor :meteor
+
+	def viewDidLoad
+		super
+		self.view.backgroundColor = UIColor.whiteColor
+		self.title = "Books"
+
+		@table = UITableView.alloc.initWithFrame(self.view.bounds)
+    self.view.addSubview @table
+
+    @table.dataSource = self
+    @table.delegate = self
+
+    @books = @meteor.collections['books']
+    @books.add_observer(@table.method(:reloadData))
+
+    right_button = UIBarButtonItem.alloc.initWithTitle("Add Book", style: UIBarButtonItemStyleDone, target:self, action:'add_book')
+  	self.navigationItem.rightBarButtonItem = right_button
+	end
+
+	def add_book
+		book = {}
+	  form = build_book_form( book )
+
+	  bookController = BookController.alloc.initWithForm(form)
+	  bookController.meteor = @meteor
+	  bookController._id = nil
+
+	  self.navigationController.pushViewController(bookController, animated: true)
+	end
+
+
+	def tableView(tableView, cellForRowAtIndexPath: indexPath)
+    @reuseIdentifier ||= "CELL_IDENTIFIER"
+
+    cell = tableView.dequeueReusableCellWithIdentifier(@reuseIdentifier) || begin
+      UITableViewCell.alloc.initWithStyle(UITableViewCellStyleDefault, reuseIdentifier:@reuseIdentifier)
+    end
+
+    cell.textLabel.text = @books.all[indexPath.row]['title']
+
+    cell
+  end
+
+
+  def tableView(tableView, numberOfRowsInSection: section)
+    @books.size
+  end
+
+
+  def tableView(tableView, didSelectRowAtIndexPath:indexPath)
+	  tableView.deselectRowAtIndexPath(indexPath, animated: true)
+
+	  book = @books.all[indexPath.row]
+	  form = build_book_form( book )
+
+	  bookController = BookController.alloc.initWithForm(form)
+	  bookController.meteor = @meteor
+	  bookController._id = book[:_id]
+
+	  self.navigationController.pushViewController(bookController, animated: true)
+	end
+
+
+	def build_book_form book
+		form = Formotion::Form.new
+
+		form.build_section do |section|
+		  section.title = "Book Details"
+
+		  section.build_row do |row|
+		    row.title = "Title"
+		    row.key = :title
+		    row.type = :string
+	  		row.placeholder = 'Book title'
+	  		row.value = book['title']
+		  end
+
+		  section.build_row do |row|
+		    row.title = "Author"
+		    row.key = :author
+		    row.type = :string
+	  		row.placeholder = 'Book author'
+	  		row.value = book['author']
+		  end
+
+		  section.build_row do |row|
+		    row.title = "Year"
+		    row.key = :year
+		    row.type = :string
+	  		row.placeholder = 'Book year'
+	  		row.value = book['year']
+		  end
+
+		  section.build_row do |row|
+		  	row.title = 'Save Changes'
+		  	row.type = :submit
+		  end
+		end
+
+		return form
+	end
+
+end