ruby_motion_query 0.4.1 → 0.5.0

checksums.yaml

@@ -1,15 +1,15 @@
 ---
 !binary "U0hBMQ==":
   metadata.gz: !binary |-
-    YWFmNzE0NjljMGNjYTRhYmYxYTIxMWQ3MGE1YTY1ODI0Y2E0M2EyNw==
+    MzUyNDAwZmQ1YTRmMzBiODg3YTMzY2VlMzNiYTA1ZTFjOWY2OGU3Yg==
   data.tar.gz: !binary |-
-    M2RjODk1NDgyMmQ2ODc1MDFlZjc2ODg3YWVkMzMwZTk5YWNiMTMxZA==
+    ZTljMmU0NDcyZDFjNWEyZjEzZGYzZWQ0YjY1YmEzZjUyOWJkZDY1YQ==
 !binary "U0hBNTEy":
   metadata.gz: !binary |-
-    Y2MxY2YyZGU0ZDdiZmQxNzAwNTk3NWFlNjA2NGUzNmJhMzVkYTMzMWUxN2Ri
-    NjBlNmZiYjEzNWY2Nzc2ZDcyZTlmNmU4NDZlOTk3MDM3ZmQ2MWExYjY3YjI2
-    ODkzZWFlNmI4ZThlODAzMTczYjU4MTAzOWI5YWI3Yjk3MzgzNTQ=
+    NDU2MGU1YmJiNmQzZGFhMjExZWVlYTVmN2IwMzkyN2E0NTBiODQwMjU1NzRh
+    ZmQ1M2JhZDExMmE4N2FkMjY5NDNmNzdiOTE5OWVkNjk0ODM0MWFhY2FhMTJj
+    MTEwNzAwOWM0MzY0ZGI0M2NhM2QxNmYxMmEyOWY2YzE0YTNlNzQ=
   data.tar.gz: !binary |-
-    YjRlNjg1YjRkNzk5MmYwYzZiZWY2MjJmYTc5ZWRjZWRhZmZlMTVjZWZlNTVm
-    ZTQ3Yjg5M2I4YWJjZDM0MDk4ODBiMzJhYzUxOGRlOTI3NGIwYzZlOWJlOGE1
-    YzljNTlhMTkzMDZlNGVkMzE3MjhjZWEzM2U5M2RhMDY1NDQ5YTc=
+    NTY2NTJmNzhmZTE5YjcyZTcxYTc5ZjcxZDk2ZjBjYjAxYTU5MDc1OTE2NGRi
+    YjkyMzNkNGYzMmU3NGQwNTcxYjMwODA4Mjg3MTk4M2IzNGRlNWQwMjBlYWRl
+    NGVlMDdkN2FjNjE0YzRiZDJjNjdkNzkyMjhjYjIxMDlmNWNjYjY=

data/README.md

@@ -1,13 +1,13 @@
 ![RQM logo](http://ir_wp.s3.amazonaws.com/wp-content/uploads/sites/9/2013/07/rmq_logo.png)
 
 # RubyMotionQuery - RMQ
-A fast, muggle, nonpolluting, jQuery-like library for [RubyMotion](http://rubymotion.com).
+A fast, muggle, nonpolluting, zero-dependency, jQuery-like library for [RubyMotion](http://rubymotion.com).
 
 **The [RMQ Introductory Guide and other info][1] is a great place to start.**
 
 [![Dependency Status](https://gemnasium.com/infinitered/rmq.png)](https://gemnasium.com/infinitered/rmq)
 [![Build Status](https://travis-ci.org/infinitered/rmq.png?branch=master)](https://travis-ci.org/infinitered/rmq)
-
+[![Gem Version](https://badge.fury.io/rb/ruby_motion_query.png)](http://badge.fury.io/rb/ruby_motion_query)
 
 ## General
 
@@ -33,7 +33,7 @@ A fast, muggle, nonpolluting, jQuery-like library for [RubyMotion](http://rubymo
 ### Other wrapper libraries
 There are a lot of great wrappers out there such as Teacup and Sugarcube. I've used these and I enjoy them. However, many of the wrappers heavily pollute the standard classes, which is great if you like that sort of thing. RMQ is designed to have minimal pollution, to be very simple and high performance (it will be when it's done). RMQ shouldn't conflict with anything.
 
-RMQ **doesn't require any** other wrapper or gem. 
+RMQ **doesn't require any** other wrapper or gem.
 
 > If you preferred jQuery over Prototype, you'll love RMQ.
 
@@ -83,6 +83,12 @@ for **bleeding edge**, add this to your `Gemfile`:
 
 - `gem 'ruby_motion_query', :git => 'git@github.com:infinitered/rmq.git'`
 
+
+## Deprecation
+
+- **UIView#rmq_did_create(self_in_rmq)** - *Use rmq_build instead*
+
+
 ## Usage
 
 ### Example App
@@ -98,7 +104,7 @@ The example app works in any orientation, on both iPhone and iPad. Notice how th
 
  - an rmq instance is an array-like object containing UIViews
  - rmq() never returns nil. If nothing is selected, it's an empty [ ] array-like
-   object   
+   object
  - an rmq object always (almost always) returns either itself or a new
    rmq object. This is  how chaining works. You do not need to worry if
    an rmq is blank or not, everything  always works without throwing a
@@ -183,7 +189,7 @@ Here are the commands available to you:
  > rmq create shared some_class_used_app_wide
  > rmq create lib some_class_used_by_multiple_apps
 
- > rmq create collection_view_controller foos 
+ > rmq create collection_view_controller foos
 
  # To test the create command without actually creating any files, do:
  > rmq create view my_view dry_run
@@ -208,7 +214,7 @@ Here are the commands available to you:
  - and
  - not
  - and_self
- - end
+ - back  - rmq(test_view).find(UIImageView).tag(:foo).back.find(UILabel).tag(:bar) 
  - find
  - children
  - siblings
@@ -242,7 +248,7 @@ all return another rmq instance, so you can chain.
 
 You can also do **rmq.length** and **rmq[0]** like an array
 
-**.to_a** gives you an actual array, so will **.get** (this is preferred) 
+**.to_a** gives you an actual array, so will **.get** (this is preferred)
 
 ### Events and Gestures
 
@@ -309,7 +315,7 @@ If you see Event, just remember that's either an event or gesture. I decided to
 :system
 :all
 
-# Gestures 
+# Gestures
 :tap
 :pinch
 :rotate
@@ -405,21 +411,21 @@ rmq.view_controller
 
 #### Create a view
 If you want to create a view but not add it to the subviews of any other view, you can
-use #create. It's basically #append without the actual appending. 
+use #create. It's basically #append without the actual appending.
 This is very handy for stuff like table cells:
 
 ```ruby
 # In your controller that is a delegate for a UITableView
 def tableView(table_view, cellForRowAtIndexPath: index_path)
-  cell = tableView.dequeueReusableCellWithIdentifier(CELL_IDENTIFIER) || begin 
-    rmq.create(StoreCell, :store_cell)
+  cell = table_view.dequeueReusableCellWithIdentifier(CELL_IDENTIFIER) || begin
+    rmq.create(StoreCell, :store_cell, cell_identifier: CELL_IDENTIFIER).get
   end
 end
 
 # Your cell
-class StoreCell < UITableViewCell 
-  def rmq_did_create(self_in_rmq)
-    self_in_rmq.append(UILabel, :title_label) # <- this works even though this object isn't in a controller
+class StoreCell < UITableViewCell
+  def rmq_build
+    rmq(self).append(UILabel, :title_label) # <- this works even though this object isn't in a controller
   end
 end
 ```
@@ -436,14 +442,14 @@ rmq(my_view).animate(
 ```
 
 ```ruby
-# As an example, this is the implementation of .animations.throb 
+# As an example, this is the implementation of .animations.throb
 rmq(selectors).animate(
   duration: 0.1,
   animations: -> (q) {
     q.style {|st| st.scale = 1.1}
   },
   completion: -> (did_finish, q) {
-    q.animate( 
+    q.animate(
       duration: 0.4,
       animations: -> (cq) {
         cq.style {|st| st.scale = 1.0}
@@ -457,7 +463,7 @@ rmq(selectors).animate(
 
 ### Animations
 
-#### Current animations included: 
+#### Current animations included:
 
 ```ruby
 rmq(my_view).animations.fade_in
@@ -483,7 +489,7 @@ rmq.color.from_rgba(128, 128, 128, 0.5)
 
 # Add a new standard color
 rmq.color.add_named :pitch_black, '#000000'
-# Or 
+# Or
 rmq.color.add_named :pitch_black, rmq.color.black
 
 # In a stylesheet you don't need the rmq
@@ -503,7 +509,7 @@ rmq.font.for_family('Helvetica') # useful in console
 font_family = 'Helvetica Neue'
 font.add_named :large,    font_family, 36
 font.add_named :medium,   font_family, 24
-font.add_named :small,    font_family, 18 
+font.add_named :small,    font_family, 18
 
 # then use them like so
 rmq.font.large
@@ -576,7 +582,7 @@ rmq.device.iphone?
 rmq.device.four_inch?
 rmq.device.retina?
 
-# return values are :unkown, :portrait, :portrait_upside_down, :landscape_Left, 
+# return values are :unkown, :portrait, :portrait_upside_down, :landscape_Left,
 # :landscape_right, :face_up, :face_down
 rmq.device.orientation
 rmq.device.landscape?
@@ -603,23 +609,25 @@ RubyMotionQuery::RMQ.is_class?(foo)
 RubyMotionQuery::RMQ.is_blank?(foo)
 RubyMotionQuery::RMQ.controller_for_view(view)
 RubyMotionQuery::RMQ.view_to_s(view)
+RubyMotionQuery::RMQ.weak_ref(foo)
 ```
 
-### Pollution 
+### Pollution
 
 The following are the only pollution in RMQ
 
  - UIView
-   - rmq
-   - rmq_data
+    - rmq
+    - rmq_data
  - UIViewController
-   - rmq
-   - rmq_data
- - TopLevel  *(Only in development, used for console)*
-   - rmq
+    - rmq
+    - rmq_data
+ - Object
+    - rmq
 
 ### Console Fun
 
+  rmq.log :tree
 	rmq.all.log
 	rmq.all.log :wide
 	rmq(UIView).show
@@ -635,7 +643,7 @@ The following are the only pollution in RMQ
    - models
    - shared
    - stylers
-         - ui_view_styler.rb 
+         - ui_view_styler.rb
          - ui_button_styler.rb
          - etc
    - stylesheets
@@ -654,7 +662,7 @@ The following are the only pollution in RMQ
    - stylers
    - views
 
-### Debugging 
+### Debugging
 
 Adding rmq_debug=true to rake turns on some debugging features that are too slow or verbose to include in a normal build.  It's great for normal use in the simulator, but you'll want to leave it off if you're measuring performance.
 ```
@@ -750,10 +758,10 @@ class ApplicationStylesheet < RubyMotionQuery::Stylesheet
     font_family = 'Helvetica Neue'
     font.add_named :large,    font_family, 36
     font.add_named :medium,   font_family, 24
-    font.add_named :small,    font_family, 18 
+    font.add_named :small,    font_family, 18
 
-    color.add_named :translucent_black, color.from_rgba(0, 0, 0, 0.4) 
-    color.add_named :battleship_gray,   '#7F7F7F' 
+    color.add_named :translucent_black, color.from_rgba(0, 0, 0, 0.4)
+    color.add_named :battleship_gray,   '#7F7F7F'
   end
 
   def label(st)
@@ -905,7 +913,7 @@ class MainStylesheet < ApplicationStylesheet
   end
 
   def overlay(st)
-    st.frame = :full 
+    st.frame = :full
     st.background_color = color.translucent_black
     st.hidden = true
     st.z_position = 99
@@ -1058,13 +1066,13 @@ end
 
 #### Add your own stylers
 
-In the example app, look in **/app/stylers**, you can just copy that whole folder to start. Then add methods to the appropriate class. 
+In the example app, look in **/app/stylers**, you can just copy that whole folder to start. Then add methods to the appropriate class.
 
 Here is an example of adding a method to all stylers:
 ```ruby
 module RubyMotionQuery
   module Stylers
-    class UIViewStyler 
+    class UIViewStyler
 
       def border_width=(value)
         @view.layer.borderWidth = value
@@ -1072,7 +1080,7 @@ module RubyMotionQuery
       def border_width
         @view.layer.borderWidth
       end
- 
+
     end
   end
 end
@@ -1083,20 +1091,34 @@ You can also include all of your custom stylers in one file, which works well if
 
 ### Creating your own views
 
-If you use RMQ's stylesheets and you create your own views, you should add your subviews and such in this method:
+RMQ calls 3 methods when you create, append, or build a view using rmq. rmq_build is the one you most want to use
 ```ruby
-def rmq_did_create
+def rmq_build
+end
+
+def rmq_created
 end
+
+def rmq_appended
+end
+```
+If you append a view like so:
+```ruby
+rmq.append(UILabel)
 ```
+The 3 methods will be called in this order:
+- rmq_created
+- rmq_appended
+- rmq_build
 
 In the following example an instance of YourView is created, :your_style is applied
-then rmq_did_create is called on the instance that was just created. In that
+then rmq_build is called on the instance that was just created. In that
 order.
 
 ```ruby
 # Your view
 class YourView < UIView
-  def rmq_did_create
+  def rmq_build
     rmq(self).tap do |q|
       q.append(UILabel, :section_title)
       q.append(UIButton, :buy_button).on(:tap) do |sender|
@@ -1105,20 +1127,37 @@ class YourView < UIView
     end
   end
 end
-  
+
 # In your controller
 rmq.append(YourView, :your_style)
 ```
 
 ### Future features
 
-Future features that I plan on adding
+Current roadmap:
+
+- v0.5 new view_controller system: which solves the #1 problem in rmq: having to pass rmq around in things like cells. rmq command will work everywhere
+- v0.6 new frame system: I’ve already designed this, I just have to implement it and use it in the real world and tweak. This is going to be very cool. It adds to the existing frame system. It doesn’t replace constraints, but rather gives you almost all the features you need without the complexity of constraints.
+- v0.6.5 templates and stylers all finished
+- v0.6.7 performance improvements
+- v0.7 first rmq plugin and any base features needed to support plugins (I don’t think there will be any base features needed)
+- v0.8 binding system
+- ?
+- ?
+- v1.0
+
+Random future features that I plan on adding
 
 - rmq.push_sub_controller(my_controller) and rmq.pop_sub_controller and rmq.pop_this_controller
 - add borders to UIView styler: st.borders = {l: {w: 2, color: color.black}, r: {w: 2, color: color.black}}
 - add templates for: nav controller, tab controller, table controller, collection controller
 - add from_right, from_bottom, and centered to both st.frame and to move
 - add binding that combines KVO and events to bind an attribute of one object to the attribute of selected view(s), keeping both in sync, like so: rmq.append(UITextField).bind(@person, attr: :name, to: :text)
+- rmq.log to wrap nslog to allow you to turn off logging (or does NSLog already have this feature?)
+- add selectors for UITextField
+- add string to height utility, given the font and the width
+- add block to wrap useful for a variety of things, but here is solid example: rmq.append(UIButton).tag(:foo).wrap{|view| view.titleLabel}.tag(:foo_title)
+- add def rmq_build_with_properties(props = {}). Perhaps remove rmq_created and rmq_appended, not sure if those are usefull or not
 
 
 ## Contact
@@ -1145,6 +1184,6 @@ RMQ is available under the MIT license. See the LICENSE file for more info.
 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	
+5. Create new Pull Request
 
   [1]: http://infinitered.com/rmq

data/motion/ext.rb

@@ -1,33 +1,28 @@
+class Object
+  def rmq(*working_selectors)
+    if window = RubyMotionQuery::RMQ.app.window
+      RubyMotionQuery::RMQ.app.current_view_controller.rmq(working_selectors)
+    end
+  end
+end
+
 class UIView
   def rmq_data
     @_rmq_data ||= RubyMotionQuery::ViewData.new
   end
 
-  # Override in your view if you want to setup subviews after your view has 
-  # been created by rmq, usually through an #append or #create
-  #
-  # @param [RMQ] rmq that created your view
-  #
-  # In your view
-  # @example
-  #   def rmq_did_create(self_in_rmq)
-  #     self_in_rmq.tap do |q|
-  #       q.append(UILabel, :section_title)
-  #       q.append(UIButton, :buy_button).on(:tap) do |sender|
-  #         # do  something
-  #       end
-  #     end
-  #   end
-  #
-  # In your controller
-  # @example
-  #   rmq.append(YourView, :your_style)
-  #
-  # In this example an instance of YourView is created, :your_style is applied
-  # then rmq_did_create is called on the instance that was just created. In that
-  # order.
+  # @deprecated No longer needed, use rmq_build
   def rmq_did_create(self_in_rmq)
   end
+  def rmq_created
+  end
+
+  # Override this to build your view and view's subviews
+  def rmq_build
+  end
+
+  def rmq_appended
+  end
 
   # I intend for this to be protected
   # Do not call rmq from outside a view. Because of some weirdness with table cells
@@ -36,17 +31,23 @@ class UIView
   # Technically my_view.rmq is the same as rmq(my_view), so it may seem enticing to use
   # but the really nice thing about rmq is its consistent API, and doing this
   # for one view: my_view.rmq and this for two views: rmq(my_view, my_other_view) sucks
-  def rmq(*selectors)
-    RubyMotionQuery::RMQ.create_with_selectors(selectors, self)
+  def rmq(*working_selectors)
+    RubyMotionQuery::RMQ.create_with_selectors(working_selectors, self).tap do |o|
+      if vc = self.rmq_data.view_controller
+        o.weak_view_controller = vc
+      end
+    end
   end
 end
 
 class UIViewController
-  def rmq(*selectors)
-    if RubyMotionQuery::RMQ.cache_controller_rmqs && selectors.length == 0
-      rmq_data.rmq ||= RubyMotionQuery::RMQ.create_with_selectors(selectors, self)
+  def rmq(*working_selectors)
+    crmq = (rmq_data.cached_rmq ||= RubyMotionQuery::RMQ.create_with_selectors([], self))
+
+    if working_selectors.length == 0
+      crmq
     else
-      RubyMotionQuery::RMQ.create_with_selectors(selectors, self, rmq_data.rmq)
+      RubyMotionQuery::RMQ.create_with_selectors(working_selectors, self, crmq)
     end
   end
 
@@ -54,12 +55,3 @@ class UIViewController
     @_rmq_data ||= RubyMotionQuery::ControllerData.new
   end
 end
-
-# Used in console, so that you can just call rmq with an view or controller as self
-class TopLevel
-  def rmq(*selectors)
-    if window = RubyMotionQuery::RMQ.app.window
-      RubyMotionQuery::RMQ.create_with_selectors(selectors, window.subviews.first)
-    end
-  end
-end