motion-callback 0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 6fa0e287cf4277dc3cb54bef99cb031d3e54fafe
+  data.tar.gz: ffb74cb12edee85bd8e4f8bba4d2f82f8e82c8e4
+SHA512:
+  metadata.gz: 819840f8b31f613847bc8051d312f56d4b38bcc37032d2a60211dfa6ffffa8a9c174a093b1b39fc164292a382d71627edd145b319e2fbfb664a6a26143fdc920
+  data.tar.gz: db416c9f9c92a332dedaae28419d640000361e7dba600eb1a25f6d40aeeaf572e23b2cb42b48e5ce113a63e98508b4642d1a5686bb0676a3267479410db4df9d

data/README.md

@@ -0,0 +1,83 @@
+# motion-callback
+
+Allows for multi-branch callbacks from a single method. This allows for blocks of code
+to be invoked in response to asynchronous events triggered in the called method.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'callback'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install motion-callback
+
+## Usage
+
+Using `callbacks` is really easy. Just add it to your Gemfile. Then in your code do this:
+
+```ruby
+do_something_complicated do |on|
+  on.success {
+    # take actions based on success
+  }
+  on.failure {
+    # crash and burn gracefully
+  }
+  on.indeterminate_state {
+    # act really confused
+  }
+end
+```
+
+In your `do_something_complicated` method, write code like this:
+
+```ruby
+def do_something_complicated(&block)
+  some_asynchronous_stuff{|status|
+    case status
+    when 'error' then block.call Callback.new(:error)
+    when 'success' then block.call Callback.new(:success)
+    when '???'     then block.call Callback.new(:indeterminate_state)
+    end
+  }
+end
+```
+
+A better idea of why this is interesting is code that reaches out
+to a remote for asynchronously-retrieved data like this:
+
+```ruby
+check_already_logged_in do |on|
+  on.success{ transition_to_authenticated_user_section }
+  on.failure{
+    login do |on|
+      on.success{ transition_to_authenticated_user_section }
+      on.failure{ alert_user_to_screwup }
+    end
+  }
+end
+```
+
+## Thanks To
+
+[Emmanuel Oga](https://gist.github.com/EmmanuelOga)
+
+and this Gist, which is essentially the entire Gem.
+
+https://gist.github.com/EmmanuelOga/1417762
+
+Note also [this blog post and the ensuing discussion](http://www.mattsears.com/articles/2011/11/27/ruby-blocks-as-dynamic-callbacks).
+
+## 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/lib/callback.rb

@@ -0,0 +1,10 @@
+# encoding: utf-8
+
+unless defined?(Motion::Project::Config)
+  raise "This file must be required within a RubyMotion project Rakefile."
+end
+
+lib_dir_path = File.dirname(File.expand_path(__FILE__))
+Motion::Project::App.setup do |app|
+  app.files.unshift(Dir.glob(File.join(lib_dir_path, "project/**/*.rb")))
+end

data/lib/project/callback.rb

@@ -0,0 +1,5 @@
+Callback = Struct.new(:called, :args) do
+  def method_missing(name, *)
+    name == :"#{called}?" || (name == called && block_given? && yield(*args))
+  end
+end

metadata

@@ -0,0 +1,63 @@
+--- !ruby/object:Gem::Specification
+name: motion-callback
+version: !ruby/object:Gem::Version
+  version: '0.1'
+platform: ruby
+authors:
+- Steve Ross
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-06-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: |-
+  Allows for multi-branch callbacks from a single method. This allows for blocks of code
+  to be invoked in response to asynchronous events triggered in the called method.
+email:
+- sxross@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/callback.rb
+- lib/project/callback.rb
+homepage: ''
+licenses:
+- ''
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Multi-branch callbacks
+test_files: []