motion-kit 0.11.2 → 0.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 178a4a8d53c639db16f7d73765521a9ee5b220b5
-  data.tar.gz: bd48860c5baff3f5ee0543c28426b6c2d63e09f5
+  metadata.gz: 1027d089bb3ce6aafe9f4f55d152a6e3c22a4511
+  data.tar.gz: 7e6b2b1bca51e2d3e0aae3d71a2adb76cf31c768
 SHA512:
-  metadata.gz: b8b0dd1b76e3875e5aa86dddf9d2e56862b3f5954e7ef33413ad430750a0b3a0565e56355597c9428ac5d322d17c593c48d009a157a6adff10ec1c01567a3706
-  data.tar.gz: 368ac319ec7994a9a7623ea6c4149c61372f9f087041cc77b6f4b2830f1d1a1d176b467e59fe7bef026c393fddc51ad064b53b18865a4ef6b907b670f991ba0e
+  metadata.gz: f45d382fbffb1edea0cf1f4f53ca14344d997de32441319a4978d428fecf5721fe32f51e67c37437e28f335b932ab3ee3747059e6c269ec1f96df15f5bf032c2
+  data.tar.gz: 02332a86a6625fa6175423524e4bc94865a34c2d7da9a39318699edd144dea3e54893276c38331680e736ba64c67280a68284aa4852fdb31baaf99f2f8edf3b5

data/README.md

@@ -354,7 +354,7 @@ that take multiple arguments.  Those can get "helper" methods.
   # title on a UIButton
   def login_button_style
     title 'Press me'
-    # this gets delegated to UIButtonLayout#title(title), which in turn calls
+    # this gets delegated to UIButtonHelpers#title(title), which in turn calls
     # button.setTitle(title, forState: UIControlStateNormal)
   end
 ```
@@ -383,15 +383,18 @@ Introspection and method_missing add a little overhead to your code, but in our
 benchmarking it is insignificant and undetectable. Let us know if you find any
 performance issues.
 
-You can easily add your own helpers to MotionKit's existing Layout classes. They
-are all named consistenly, e.g. `MotionKit::UIViewLayout`, e.g.
-`MotionKit::UILabelLayout`.  Just open up these classes and hack away.
+You can easily add your own helpers to MotionKit. They
+are all named consistenly, e.g. `MotionKit::UIViewHelpers`, e.g.
+`MotionKit::UILabelHelpers`.  You just need to specify the "target class" that
+your helper class is meant to work with.  Each class can only have *one helper
+class*.
 
 ```ruby
 module MotionKit
   # these helpers will only be applied to instances of UILabel and UILabel
   # subclasses
-  class UILabelLayout
+  class UILabelHelpers < UIViewHelpers
+    targets UILabel
 
     # style methods can accept any number of arguments, and a block. The current
     # view should be referred to via the method `target`
@@ -426,19 +429,19 @@ end
 
 For your own custom classes, or when you want to write
 helper methods for a built-in class, you will need to write a class that
-"`targets`" that class.  This will be a subclass of `MK::UIViewLayout`; it looks
+"`targets`" that class.  This will be a subclass of `MK::UIViewHelpers`; it looks
 and *feels* like a `MK::Layout` subclass, but these classes are used to extend
 the MotionKit DSL, and should not be instantiated or used to build layouts.
 
 Again, to be clear: you should be subclassing `MK::Layout` when you build your
-controller layouts, and you should write a subclass of `MK::UIViewLayout` *only*
+controller layouts, and you should write a subclass of `MK::UIViewHelpers` *only*
 when you are adding extensions to the MotionKit DSL.
 
 ```ruby
-# Be sure to extend an existing Layout class, otherwise you'll lose a lot of
-# functionality.  Often this will be `MK::UIViewLayout` on iOS and
-# `MK::NSViewLayout` on OS X.
-class CustomLayout < MK::UIViewLayout
+# Be sure to extend an existing Helpers class, otherwise you'll lose a lot of
+# functionality.  Often this will be `MK::UIViewHelpers` on iOS and
+# `MK::NSViewHelpers` on OS X.
+class CustomViewHelpers < MK::UIViewHelpers
   targets CustomView
 
   def fore_color(value)
@@ -707,7 +710,7 @@ view, you need to use a separate method that is called after the view hierarchy
 is created.
 
 ```ruby
-class MainLayout < UIViewLayout
+class MainLayout < MK::Layout
 
   def layout
     add UILabel, :label do

data/lib/motion-kit-cocoa/constraints/{constraints_layout.rb → constraints_helpers.rb}

@@ -1,8 +1,8 @@
-# @provides MotionKit::ConstraintsLayout
+# @provides MotionKit::ConstraintsHelpers
 # @requires MotionKit::BaseLayout
 # @requires MotionKit::ConstraintsTarget
 module MotionKit
-  class ConstraintsLayout < BaseLayout
+  class ConstraintsHelpers < BaseLayout
     targets ConstraintsTarget
 
     # A more sensible name for the constraint that is created.

data/lib/motion-kit-cocoa/layouts/{cagradientlayer_layout.rb → cagradientlayer_helpers.rb}

@@ -1,8 +1,8 @@
-# @provides MotionKit::CAGradientLayerLayout
-# @requires MotionKit::CALayerLayout
+# @provides MotionKit::CAGradientLayerHelpers
+# @requires MotionKit::CALayerHelpers
 # @requires MotionKit::TreeLayout
 module MotionKit
-  class CAGradientLayerLayout < CALayerLayout
+  class CAGradientLayerHelpers < CALayerHelpers
     targets CAGradientLayer
 
     def colors(values)

data/lib/motion-kit-cocoa/layouts/{calayer_layout.rb → calayer_helpers.rb}

@@ -1,7 +1,7 @@
-# @provides MotionKit::CALayerLayout
+# @provides MotionKit::CALayerHelpers
 # @requires MotionKit::TreeLayout
 module MotionKit
-  class CALayerLayout < TreeLayout
+  class CALayerHelpers < TreeLayout
     targets CALayer
 
     # platform specific default root view

data/lib/motion-kit-cocoa/layouts/sugarcube_compat.rb

@@ -1,5 +1,5 @@
 # These methods are defined in SugarCube's REPL helpers, but we want them to be
-# delegated to either `UIViewLayout#frame` or `CALayer#setFrame`
+# delegated to either `UIViewHelpers#frame` or `CALayer#setFrame`
 #
 # @requires MotionKit::BaseLayout
 module MotionKit

data/lib/motion-kit-ios/deprecated.rb

@@ -0,0 +1,31 @@
+# @requires MotionKit::UIViewHelpers
+# @requires MotionKit::UIButtonHelpers
+# @requires MotionKit::CALayerHelpers
+# @requires MotionKit::CAGradientLayerHelpers
+module MotionKit
+
+  class UIViewLayout < UIViewHelpers
+    def self.inherited(subclass)
+      NSLog("Sorry!  MotionKit changed.  UIViewLayout is now UIViewHelpers.  Update #{subclass} to extend from UIViewHelpers.")
+    end
+  end
+
+  class UIButtonLayout < UIButtonHelpers
+    def self.inherited(subclass)
+      NSLog("Sorry!  MotionKit changed.  UIButtonLayout is now UIButtonHelpers.  Update #{subclass} to extend from UIButtonHelpers.")
+    end
+  end
+
+  class CALayerLayout < CALayerHelpers
+    def self.inherited(subclass)
+      NSLog("Sorry!  MotionKit changed.  CALayerLayout is now CALayerHelpers.  Update #{subclass} to extend from CALayerHelpers.")
+    end
+  end
+
+  class CAGradientLayerLayout < CAGradientLayerHelpers
+    def self.inherited(subclass)
+      NSLog("Sorry!  MotionKit changed.  CAGradientLayerLayout is now CAGradientLayerHelpers.  Update #{subclass} to extend from CAGradientLayerHelpers.")
+    end
+  end
+
+end

data/lib/motion-kit-ios/layouts/{constraints_layout.rb → constraints_helpers.rb}

@@ -1,6 +1,6 @@
-# @requires MotionKit::UIViewLayout
+# @requires MotionKit::UIViewHelpers
 module MotionKit
-  class UIViewLayout
+  class UIViewHelpers
 
     def content_compression_resistance_priority(value, for_axis: axis)
       axis = Constraint.axis_lookup(axis)

data/lib/motion-kit-ios/layouts/{uibutton_layout.rb → uibutton_helpers.rb}

@@ -1,7 +1,7 @@
-# @provides MotionKit::UIButtonLayout
-# @requires MotionKit::UIViewLayout
+# @provides MotionKit::UIButtonHelpers
+# @requires MotionKit::UIViewHelpers
 module MotionKit
-  class UIButtonLayout < UIViewLayout
+  class UIButtonHelpers < UIViewHelpers
     targets UIButton
 
     def title(value)

data/lib/motion-kit-ios/layouts/{uiview_layout.rb → uiview_helpers.rb}

@@ -1,5 +1,5 @@
 # @provides MotionKit::Layout
-# @provides MotionKit::UIViewLayout
+# @provides MotionKit::UIViewHelpers
 # @requires MotionKit::TreeLayout
 module MotionKit
   class Layout < TreeLayout
@@ -21,7 +21,7 @@ module MotionKit
 
   end
 
-  class UIViewLayout < Layout
+  class UIViewHelpers < Layout
     targets UIView
   end
 

data/lib/motion-kit-ios/layouts/uiview_layout_autoresizing.rb

@@ -1,6 +1,6 @@
-# @requires MotionKit::UIViewLayout
+# @requires MotionKit::UIViewHelpers
 module MotionKit
-  class UIViewLayout
+  class UIViewHelpers
 
     def autoresizing_mask(*values)
       value = 0

data/lib/motion-kit-ios/layouts/uiview_layout_constraints.rb

@@ -1,6 +1,6 @@
-# @requires MotionKit::UIViewLayout
+# @requires MotionKit::UIViewHelpers
 module MotionKit
-  class UIViewLayout
+  class UIViewHelpers
 
     def constraints(add_to_view=nil, &block)
       add_to_view ||= target

data/lib/motion-kit-ios/layouts/uiview_layout_frame.rb

@@ -1,6 +1,6 @@
-# @requires MotionKit::UIViewLayout
+# @requires MotionKit::UIViewHelpers
 module MotionKit
-  class UIViewLayout
+  class UIViewHelpers
 
     def x(value)
       f = target.frame

data/lib/motion-kit-ios/layouts/uiview_layout_gradient.rb

@@ -1,6 +1,6 @@
-# @requires MotionKit::UIViewLayout
+# @requires MotionKit::UIViewHelpers
 module MotionKit
-  class UIViewLayout
+  class UIViewHelpers
 
     # gradient colors:
     def gradient(&block)

data/lib/motion-kit-osx/deprecated.rb

@@ -0,0 +1,52 @@
+# @requires MotionKit::NSWindowHelpers
+# @requires MotionKit::NSViewHelpers
+# @requires MotionKit::NSTableViewHelpers
+# @requires MotionKit::NSTableColumnHelpers
+# @requires MotionKit::NSMenuHelpers
+# @requires MotionKit::CALayerHelpers
+# @requires MotionKit::CAGradientLayerHelpers
+module MotionKit
+
+  class NSWindowLayout < NSWindowHelpers
+    def self.inherited(subclass)
+      NSLog("Sorry!  MotionKit changed.  NSWindowLayout is now NSWindowHelpers.  Update #{subclass} to extend from NSWindowHelpers.")
+    end
+  end
+
+  class NSViewLayout < NSViewHelpers
+    def self.inherited(subclass)
+      NSLog("Sorry!  MotionKit changed.  NSViewLayout is now NSViewHelpers.  Update #{subclass} to extend from NSViewHelpers.")
+    end
+  end
+
+  class NSTableViewLayout < NSTableViewHelpers
+    def self.inherited(subclass)
+      NSLog("Sorry!  MotionKit changed.  NSTableViewLayout is now NSTableViewHelpers.  Update #{subclass} to extend from NSTableViewHelpers.")
+    end
+  end
+
+  class NSTableColumnLayout < NSTableColumnHelpers
+    def self.inherited(subclass)
+      NSLog("Sorry!  MotionKit changed.  NSTableColumnLayout is now NSTableColumnHelpers.  Update #{subclass} to extend from NSTableColumnHelpers.")
+    end
+  end
+
+  class NSMenuLayout < NSMenuHelpers
+    def self.inherited(subclass)
+      NSLog("Sorry!  MotionKit changed.  NSMenuLayout is now NSMenuHelpers.  Update #{subclass} to extend from NSMenuHelpers.")
+    end
+  end
+
+  class CALayerLayout < CALayerHelpers
+    def self.inherited(subclass)
+      NSLog("Sorry!  MotionKit changed.  CALayerLayout is now CALayerHelpers.  Update #{subclass} to extend from CALayerHelpers.")
+    end
+  end
+
+  class CAGradientLayerLayout < CAGradientLayerHelpers
+    def self.inherited(subclass)
+      NSLog("Sorry!  MotionKit changed.  CAGradientLayerLayout is now CAGradientLayerHelpers.  Update #{subclass} to extend from CAGradientLayerHelpers.")
+    end
+  end
+
+end

data/lib/motion-kit-osx/layouts/{constraints_layout.rb → constraints_helpers.rb}

@@ -1,6 +1,6 @@
-# @requires MotionKit::NSViewLayout
+# @requires MotionKit::NSViewHelpers
 module MotionKit
-  class NSViewLayout
+  class NSViewHelpers
 
     def content_compression_resistance_priority(value, for_orientation: orientation)
       orientation = Constraint.orientation_lookup(orientation)

data/lib/motion-kit-osx/layouts/nsmenu_extensions.rb

@@ -1,6 +1,6 @@
-# @requires MotionKit::NSMenuLayout
+# @requires MotionKit::NSMenuHelpers
 module MotionKit
-  class NSMenuLayout
+  class NSMenuHelpers
 
     # useful when writing menus
     def app_name

data/lib/motion-kit-osx/layouts/{nsmenu_layout.rb → nsmenu_helpers.rb}

@@ -1,5 +1,5 @@
 # @provides MotionKit::MenuLayout
-# @provides MotionKit::NSMenuLayout
+# @provides MotionKit::NSMenuHelpers
 # @requires MotionKit::TreeLayout
 module MotionKit
   class MenuLayout < TreeLayout
@@ -103,7 +103,7 @@ module MotionKit
 
   end
 
-  class NSMenuLayout < MenuLayout
+  class NSMenuHelpers < MenuLayout
     targets NSMenu
   end
 end

data/lib/motion-kit-osx/layouts/nsmenuitem_extensions.rb

@@ -1,6 +1,6 @@
-# @requires MotionKit::NSMenuLayout
+# @requires MotionKit::NSMenuHelpers
 module MotionKit
-  class NSMenuLayout
+  class NSMenuHelpers
 
     ##|
     ##|  These methods are meant to be called on the parent menu item, but

data/lib/motion-kit-osx/layouts/{nstablecolumn_layout.rb → nstablecolumn_helpers.rb}

@@ -1,7 +1,7 @@
-# @provides MotionKit::NSTableColumnLayout
+# @provides MotionKit::NSTableColumnHelpers
 # @requires MotionKit::BaseLayout
 module MotionKit
-  class NSTableColumnLayout < BaseLayout
+  class NSTableColumnHelpers < BaseLayout
     targets NSTableColumn
 
     def title(value)

data/lib/motion-kit-osx/layouts/{nstableview_layout.rb → nstableview_helpers.rb}

@@ -1,7 +1,7 @@
-# @provides MotionKit::NSTableViewLayout
-# @requires MotionKit::NSViewLayout
+# @provides MotionKit::NSTableViewHelpers
+# @requires MotionKit::NSViewHelpers
 module MotionKit
-  class NSTableViewLayout < NSViewLayout
+  class NSTableViewHelpers < NSViewHelpers
     targets NSTableView
 
     def add_column(column_or_identifier, &block)

data/lib/motion-kit-osx/layouts/{nsview_layout.rb → nsview_helpers.rb}

@@ -1,5 +1,5 @@
 # @provides MotionKit::Layout
-# @provides MotionKit::NSViewLayout
+# @provides MotionKit::NSViewHelpers
 # @requires MotionKit::TreeLayout
 module MotionKit
   class Layout < TreeLayout
@@ -21,7 +21,7 @@ module MotionKit
 
   end
 
-  class NSViewLayout < Layout
+  class NSViewHelpers < Layout
     targets NSView
   end
 

data/lib/motion-kit-osx/layouts/nsview_layout_autoresizing.rb

@@ -1,6 +1,6 @@
-# @requires MotionKit::NSViewLayout
+# @requires MotionKit::NSViewHelpers
 module MotionKit
-  class NSViewLayout
+  class NSViewHelpers
 
     def autoresizing_mask(*values)
       value = 0

data/lib/motion-kit-osx/layouts/nsview_layout_constraints.rb

@@ -1,6 +1,6 @@
-# @requires MotionKit::NSViewLayout
+# @requires MotionKit::NSViewHelpers
 module MotionKit
-  class NSViewLayout
+  class NSViewHelpers
 
     def constraints(add_to_view=nil, &block)
       add_to_view ||= target

data/lib/motion-kit-osx/layouts/nsview_layout_frame.rb

@@ -1,6 +1,6 @@
-# @requires MotionKit::NSViewLayout
+# @requires MotionKit::NSViewHelpers
 module MotionKit
-  class NSViewLayout
+  class NSViewHelpers
 
     def _fix_frame_value(value)
       if value.is_a?(Hash) && value[:relative]

data/lib/motion-kit-osx/layouts/nswindow_frame.rb

@@ -1,6 +1,6 @@
-# @requires MotionKit::NSWindowLayout
+# @requires MotionKit::NSWindowHelpers
 module MotionKit
-  class NSWindowLayout
+  class NSWindowHelpers
 
     def frame(value, autosave_name=nil)
       retval = target.setFrame(value, display: true)

data/lib/motion-kit-osx/layouts/{nswindow_layout.rb → nswindow_helpers.rb}

@@ -1,5 +1,5 @@
 # @provides MotionKit::WindowLayout
-# @provides MotionKit::NSWindowLayout
+# @provides MotionKit::NSWindowHelpers
 # @requires MotionKit::TreeLayout
 module MotionKit
   class WindowLayout < TreeLayout
@@ -29,7 +29,7 @@ module MotionKit
 
   end
 
-  class NSWindowLayout < WindowLayout
+  class NSWindowHelpers < WindowLayout
     targets NSWindow
   end
 

data/lib/motion-kit/layouts/base_layout.rb

@@ -84,7 +84,7 @@ module MotionKit
     #       # passing a block to a method that returns an object. That object becomes
     #       # the new context.
     #       layer do
-    #         # self is now a CALayerLayout instance
+    #         # target is now a CALayer, and methods are delegated to CALayerHelpers
     #         corner_radius 5
     #       end
     #     end