purplish-layout 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 71e95201b9da629250ed3a65d578f119b9cbafe9
+  data.tar.gz: c15def4fd40a8016509cfc919b79a948a5a295c5
+SHA512:
+  metadata.gz: c31fc8b5ceee87292c9e509cd3ae5d84bbabfbd15e7208cd575e4d0076d0380ef2bef0d1b83dae52063db658ad20e04a018a715f9ae1baf50f008f0eb161205d
+  data.tar.gz: 300ecb78c82e7a0dfcaee0aa2917000a0e9d6e28400736352811b7ee92ce9d92cfb03de6bb3e80dc8d7aa7ad748600fd86ad029ac58dd50ef26c13818219f85f

data/.gitignore

@@ -0,0 +1,6 @@
+.rake_tasks~
+pkg/*
+build/
+.DS_Store
+.repl_history
+0

data/LICENSE

@@ -0,0 +1,10 @@
+Copyright (c) 2014, Hwee-Boon Yar
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README.md

@@ -0,0 +1,77 @@
+#purplish\_layout – a [RubyMotion](http://rubymotion.com) wrapper for Auto Layout on iOS and OS X
+
+About
+---
+Ruby lends itself to creating a nice DSL for Auto Layout, so why not? I have been using this for both iOS and OS X apps since mid-2014.
+
+Usage
+---
+Use it with visual format strings:
+
+```ruby
+['celf', inner_view, 'l', post_count_label].constraints do |celf, l, _|
+  celf.h '|[l]|'
+  celf.v '|-m-[l]-m-|', {'m' => 7}
+end
+```
+
+You can also create constraint objects yourself. This is equivalent to the previous example:
+
+```ruby
+['celf', inner_view, 'l', post_count_label].constraints do |celf, l, _|
+  celf.left = l.left
+  celf.right = l.right
+  l.top = celf.top + 7
+  l.bottom = celf.bottom - 7
+end
+```
+
+Send `#constraints` with a block to an array with an even number of elements. They should be pairs – the name (a `String`) to be used in the format strings in the block, followed by the view it represents.
+
+If there are n views involved, there should be n*2 elements in the array. The block takes n+1 arguments, and the last object is the dictionary mapping generated from the array (usually unused) and the rest of the elements are constraint proxy objects representing each view, in the order specified in the array.
+
+To avoid confusion, it's best to keep the variable names in the block the same as the string names in the array. This syntax can be improved when Proc#parameters is available.
+
+With the exception of the first view listed in the array, `translatesAutoresizingMaskIntoConstraints` is automatically set to `false` for every view, so you'll want to specify the outermost view as the first pair.
+
+A multipler can be supplied:
+
+```ruby
+  l.width = celf.width * 0.5
+```
+
+The attributes are available as `:left`, `:right`, `:top`, `:bottom`, `:leading`, `:trailing`, `:width`, `:height`, `:center_x`, `:center_y` and `:baseline`.
+
+You can mix the 2 creation methods:
+
+```ruby
+['celf', inner_view, 'l', post_count_label].constraints do |celf, l, _|
+  celf.left = l.left
+  celf.right = l.right
+  celf.v '|-m-[l]-m-|', {'m' => 7}
+end
+```
+
+There are 2 attributes in the constraint proxies that you would occasionally find useful:
+
+* `last_constraint` returns the last `NSLayoutConstraint` created. It's useful if you want to hold on to a `NSLayoutConstraint` and modify it in an animation.
+* `next_priority` sets the priority for the next `NSLayoutConstraint` you create.
+
+Installation
+---
+1. Add this to your `Gemfile`: `gem 'purplish-layout'`
+2. Run `bundle install`
+
+Dependencies
+---
+* [weak\_attr\_accessor](https://github.com/hboon/weak_attr_accessor)
+
+License
+---
+BSD. See LICENSE file.
+
+Questions
+---
+* Email: [hboon@motionobj.com](mailto:hboon@motionobj.com)
+* Web: [http://hboon.com/purplish-layout](http://hboon.com/purplish-layout)
+* Twitter: [http://twitter.com/hboon](http://twitter.com/hboon)

data/lib/purplish-layout.rb

@@ -0,0 +1,11 @@
+unless defined?(Motion::Project::Config)
+  raise "This file must be required within a RubyMotion project Rakefile."
+end
+
+Motion::Project::App.setup do |app|
+  Dir.glob(File.join(File.dirname(__FILE__), 'purplish-layout/**/*.rb')).each do |file|
+    app.files.unshift(file)
+  end
+end
+
+require 'weak_attr_accessor'

data/lib/purplish-layout/can_be_constrained.rb

@@ -0,0 +1,31 @@
+module CanBeConstrained
+  def constraint
+    #Don't bother storing it, and most importantly, don't reuse it because things like multipler and constant must always be reset
+    PurplishLayout::ConstraintProxy.new(self)
+  end
+
+  def constrained_views(*views, &block)
+    block.call(*(views.map {|e| e.constraint}))
+  end
+
+  def common_superview(v)
+    if v.superview == self
+      self
+    elsif superview == v
+      v
+    else
+      (superviews & v.superviews)[0]
+    end
+  end
+
+  def superviews
+    v = self
+    result = []
+    loop do
+      v = v.superview
+      break unless v
+      result << v
+    end
+    result
+  end
+end

data/lib/purplish-layout/ns_array.rb

@@ -0,0 +1,16 @@
+class NSArray
+  def constraints(&block)
+    mapping = Hash[*self]
+    view_constraint_proxies = each_slice(2).to_a.transpose[1].map do |e|
+      if e.nil?
+        c = nil
+      else
+        e.translatesAutoresizingMaskIntoConstraints = false if e != self[1]
+        c = e.constraint
+        c.views_mapping = mapping
+      end
+      c
+    end
+    block.call(*(view_constraint_proxies + [mapping]))
+  end
+end

data/lib/purplish-layout/ns_layout_constraint.rb

@@ -0,0 +1,27 @@
+class NSLayoutConstraint
+  def inspect
+    s = super
+    op = case relation
+         when NSLayoutRelationEqual
+           '=='
+         when NSLayoutRelationLessThanOrEqual
+           '<='
+         when NSLayoutRelationGreaterThanOrEqual
+           '>='
+         end
+    if secondAttribute == NSLayoutAttributeNotAnAttribute
+      "#{s} #{firstItem}.#{firstAttribute.to_layout_attribute} #{op} #{constant}"
+    else
+      if constant == 0
+        const_s = ''
+      else
+        const_s = " + #{constant}"
+      end
+      if multiplier == 1
+        "#{s} #{firstItem}.#{firstAttribute.to_layout_attribute} #{op} #{secondItem}.#{secondAttribute.to_layout_attribute}#{const_s}"
+      else
+        "#{s} #{firstItem}.#{firstAttribute.to_layout_attribute} #{op} #{secondItem}.#{secondAttribute.to_layout_attribute} * #{multiplier}#{const_s}"
+      end
+    end
+  end
+end

data/lib/purplish-layout/ns_number.rb

@@ -0,0 +1,28 @@
+class NSNumber
+  def to_layout_attribute
+    case self
+    when NSLayoutAttributeLeft
+      'left'
+    when NSLayoutAttributeRight
+      'right'
+    when NSLayoutAttributeTop
+      'top'
+    when NSLayoutAttributeBottom
+      'bottom'
+    when NSLayoutAttributeLeading
+      'leading'
+    when NSLayoutAttributeTrailing
+      'trailing'
+    when NSLayoutAttributeWidth
+      'width'
+    when NSLayoutAttributeHeight
+      'height'
+    when NSLayoutAttributeCenterX
+      'center_x'
+    when NSLayoutAttributeCenterY
+      'center_y'
+    when NSLayoutAttributeBaseline
+      'baseline'
+    end
+  end
+end

data/lib/purplish-layout/purplish-layout.rb

@@ -0,0 +1,135 @@
+module PurplishLayout
+  class ConstraintProxy
+    weak_attr_accessor :view
+    weak_attr_accessor :views_mapping
+    attr_accessor :attribute, :multiplier, :constant
+    attr_accessor :last_constraint
+    attr_accessor :next_priority
+
+    def initialize(view, attribute=nil, multiplier=1, constant=0)
+      @view = view
+      @attribute = attribute
+      @multiplier = multiplier
+      @constant = constant
+    end
+
+    def *(aNumber)
+      ConstraintProxy.new(view, attribute, aNumber, constant)
+    end
+
+    def +(aNumber)
+      ConstraintProxy.new(view, attribute, multiplier, aNumber)
+    end
+
+    def -(aNumber)
+      ConstraintProxy.new(view, attribute, multiplier, -aNumber)
+    end
+
+    def next_priority=(v)
+      @next_priority = v
+    end
+
+    def create_constraint_with_rhs(rhs)
+      if rhs.kind_of? self.class
+        owner = rhs.view.common_superview(view)
+        c = NSLayoutConstraint.constraintWithItem(view, attribute:attribute.to_layout_attribute, relatedBy:@operator, toItem:rhs.view, attribute:rhs.attribute.to_layout_attribute, multiplier:rhs.multiplier, constant:rhs.constant)
+        if next_priority
+          c.priority = next_priority
+          self.next_priority = nil
+        end
+        #puts "addConstraint: #{c.inspect}"
+        owner.addConstraint(c)
+        c
+      else
+        c = NSLayoutConstraint.constraintWithItem(view, attribute:attribute.to_layout_attribute, relatedBy:@operator, toItem:nil, attribute:NSLayoutAttributeNotAnAttribute, multiplier:0, constant:rhs)
+        if next_priority
+          c.priority = next_priority
+          self.next_priority = nil
+        end
+        #puts "addConstraint: #{c.inspect}"
+        view.superview.addConstraint(c)
+        c
+      end
+    end
+
+    def h(s, metrics=nil, options=0, views=nil)
+      if (s.start_with? 'H:') || (s.start_with? 'V:')
+        layout(s, metrics, options, views)
+      else
+        layout("H:#{s}", metrics, options, views)
+      end
+    end
+
+    def v(s, metrics=nil, options=0, views=nil)
+      if (s.start_with? 'H:') || (s.start_with? 'V:')
+        layout(s, metrics, options, views)
+      else
+        layout("V:#{s}", metrics, options, views)
+      end
+    end
+
+    def layout(s, metrics=nil, options=0, views=nil)
+      views ||= views_mapping
+      #Workaround, must wrap views with NSDictionary, otherwise doesn't work for RubyMotion
+      c = NSLayoutConstraint.constraintsWithVisualFormat(s, options:options, metrics:metrics, views:NSDictionary.dictionaryWithDictionary(views))
+      self.last_constraint = c
+      if next_priority
+        c.each {|e|e.priority = next_priority}
+        self.next_priority = nil
+      end
+      #puts "addConstraints:"
+      #c.each {|e| puts "  #{e.inspect}"}
+      view.addConstraints(c)
+    end
+
+    ##Attributes
+
+    def attr
+      @attribute = __method__
+      self
+    end
+
+    def attr=(rhs)
+      #Derive reader name from writer
+      @attribute = __method__[0..-3].to_sym
+      @operator = NSLayoutRelationEqual
+      self.last_constraint = create_constraint_with_rhs(rhs)
+      self
+    end
+
+    def <=(rhs)
+      @operator = NSLayoutRelationLessThanOrEqual
+      create_constraint_with_rhs(rhs)
+      self
+    end
+
+    def >=(rhs)
+      @operator = NSLayoutRelationGreaterThanOrEqual
+      create_constraint_with_rhs(rhs)
+      self
+    end
+
+    alias :left :attr
+    alias :left= :attr=
+    alias :right :attr
+    alias :right= :attr=
+    alias :top :attr
+    alias :top= :attr=
+    alias :bottom :attr
+    alias :bottom= :attr=
+    alias :leading :attr
+    alias :leading= :attr=
+    alias :trailing :attr
+    alias :trailing= :attr=
+    alias :width :attr
+    alias :width= :attr=
+    alias :height :attr
+    alias :height= :attr=
+    alias :center_x :attr
+    alias :center_x= :attr=
+    alias :center_y :attr
+    alias :center_y= :attr=
+    alias :baseline :attr
+    alias :baseline= :attr=
+  end
+end

data/lib/purplish-layout/symbol.rb

@@ -0,0 +1,28 @@
+class Symbol
+  def to_layout_attribute
+    case self
+    when :left
+      NSLayoutAttributeLeft
+    when :right
+      NSLayoutAttributeRight
+    when :top
+      NSLayoutAttributeTop
+    when :bottom
+      NSLayoutAttributeBottom
+    when :leading
+      NSLayoutAttributeLeading
+    when :trailing
+      NSLayoutAttributeTrailing
+    when :width
+      NSLayoutAttributeWidth
+    when :height
+      NSLayoutAttributeHeight
+    when :center_x
+      NSLayoutAttributeCenterX
+    when :center_y
+      NSLayoutAttributeCenterY
+    when :baseline
+      NSLayoutAttributeBaseline
+    end
+  end
+end

data/lib/purplish-layout/version.rb

@@ -0,0 +1,3 @@
+module PurplishLayout
+  VERSION = '0.0.1'
+end

data/lib/purplish-layout/view.rb

@@ -0,0 +1,7 @@
+class NSView
+  include CanBeConstrained
+end
+
+class UIView
+  include CanBeConstrained
+end

data/purplish-layout.gemspec

@@ -0,0 +1,20 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/purplish-layout/version.rb', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.name          = 'purplish-layout'
+  gem.version       = PurplishLayout::VERSION
+  gem.licenses      = ['BSD']
+
+  gem.authors  = ['Hwee-Boon Yar']
+
+  gem.description = 'A RubyMotion wrapper for Auto Layout on iOS and OS X'
+  gem.summary = 'A RubyMotion wrapper for Auto Layout on iOS and OS X'
+  gem.homepage = 'http://hboon.com/purplish-layout/'
+  gem.email = 'hboon@motionobj.com'
+
+  gem.add_dependency "weak_attr_accessor", "~> 0.0.2"
+  gem.files       = `git ls-files`.split($\)
+  gem.require_paths = ['lib']
+  #gem.test_files  = gem.files.grep(%r{^spec/})
+end

metadata

@@ -0,0 +1,70 @@
+--- !ruby/object:Gem::Specification
+name: purplish-layout
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Hwee-Boon Yar
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-02-01 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: weak_attr_accessor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.0.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.0.2
+description: A RubyMotion wrapper for Auto Layout on iOS and OS X
+email: hboon@motionobj.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- LICENSE
+- README.md
+- lib/purplish-layout.rb
+- lib/purplish-layout/can_be_constrained.rb
+- lib/purplish-layout/ns_array.rb
+- lib/purplish-layout/ns_layout_constraint.rb
+- lib/purplish-layout/ns_number.rb
+- lib/purplish-layout/purplish-layout.rb
+- lib/purplish-layout/symbol.rb
+- lib/purplish-layout/version.rb
+- lib/purplish-layout/view.rb
+- purplish-layout.gemspec
+homepage: http://hboon.com/purplish-layout/
+licenses:
+- BSD
+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.4.2
+signing_key: 
+specification_version: 4
+summary: A RubyMotion wrapper for Auto Layout on iOS and OS X
+test_files: []