OTGHelpers 0.0.5

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 23c964b4adcc7e1031874e8b824f426a5ba731cd
+  data.tar.gz: 00a864cf631979ccce71453ffe33746064885bf6
+SHA512:
+  metadata.gz: 509346ac8df21ae64104d7e99c49e71a17c10a15e1d27d9d9c04c97d6b53b1d17e99397746f844fb66d77716f8bb64435863815112620598bfab98e3c867762e
+  data.tar.gz: a6e8092fd789641a23fb54d0dc1ad180c9e4549edafacd80a4886a00e5e9833a0ce652d55d6467c32df2bfbafc7785d5309934abda67b59822b3090d112ff326

data/README.md

@@ -0,0 +1,76 @@
+# OTGHelpers
+
+A set of class extenstions I commonly use in my applications for RubyMotion.
+
+## Current additions:
+
+### UILabel
+
+#### `auto_height_for_width(change_width=false)`
+
+Automatically resizes a UILabel's height based on its contents. Optionally, it can shrink the width as well.
+
+### NSString
+
+#### `uiimage`
+
+Runs `UIImage.imageNamed(self)` for the string.
+
+#### `nsurl`
+
+Returns the string as an `NSURL`
+
+### UIView
+
+#### `add_borders(locations, color, width = 1)` aliased as `add_border`
+
+Adds borders in specified locations on a `UIView`. Possible locations are: `[:top, :left, :right, :bottom]` and can be passed singularly or in an array.
+
+#### `add_top_border(color, width)`
+#### `add_right_border(color, width)`
+#### `add_bottom_border(color, width)`
+#### `add_left_border(color, width)`
+
+These methods are used by the `add_borders` method and can be called independently if needed.
+
+#### `remove_borders` aliased as `remove_border`
+
+Removes all borders you've added on a UIView (may also remove other things you've added to the view's `layer`, so be careful with this one!)
+
+### UIImage
+
+#### `pad_to(size, args={})`
+
+Pads the size of an image to the specified size.
+
+#### `template`
+
+Returns a UIImage with UIImageRenderingModeAlwaysTemplate
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'OTGHelpers'
+```
+
+And then execute:
+
+```bash
+$ bundle
+```
+
+Or install it yourself as:
+
+```bash
+$ gem install OTGHelpers
+```
+
+## 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/OTGHelpers.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/ns_string.rb

@@ -0,0 +1,12 @@
+class NSString
+
+  # @return [UIImage]
+  def uiimage
+    UIImage.imageNamed(self)
+  end
+
+  # @return [NSURL]
+  def nsurl
+    NSURL.URLWithString(self)
+  end
+end

data/lib/project/ui_image.rb

@@ -0,0 +1,28 @@
+class UIImage
+  # Pads an image with transparency around it.
+  # Requires Sugarcube
+  def pad_to(s, args={})
+    s = CGSizeMake(s[0], s[1]) if s.is_a?(Array)
+    UIImage.canvas(size: s) do |context|
+
+      if args[:background]
+        args[:background].setFill
+        CGContextAddRect(context, [[0, 0], s])
+        CGContextDrawPath(context, KCGPathFill)
+      end
+
+      if args[:at] == :top_left
+        origin = CGPointMake(0, 0)
+      else
+        origin = CGPointMake((s.width - self.size.width) / 2, (s.height - self.size.height) / 2)
+      end
+      self.drawAtPoint(origin)
+    end
+  end
+
+  # Returns a UIImage with UIImageRenderingModeAlwaysTemplate
+  def template
+    self.imageWithRenderingMode(UIImageRenderingModeAlwaysTemplate)
+  end
+
+end

data/lib/project/ui_label.rb

@@ -0,0 +1,18 @@
+class UILabel
+  def auto_height_for_width(change_width = false)
+    self.lineBreakMode = UILineBreakModeWordWrap
+    self.numberOfLines = 0
+    maximumLabelSize = CGSizeMake(self.frame.size.width, Float::MAX)
+
+    attributedText = NSAttributedString.alloc.initWithString(self.text, attributes:{NSFontAttributeName => self.font})
+    rect = attributedText.boundingRectWithSize([self.frame.size.width, Float::MAX], options:NSStringDrawingUsesLineFragmentOrigin, context:nil)
+
+    w = change_width ? rect.size.width.ceil : self.frame.size.width
+    expected_label_size = [w, rect.size.height.ceil]
+
+    new_frame = [self.frame.origin, expected_label_size]
+    self.frame = new_frame
+  end
+  alias :autoHeightForWidth :auto_height_for_width
+
+end

data/lib/project/ui_view.rb

@@ -0,0 +1,47 @@
+class UIView
+  def add_borders(locations, color, width = 1)
+    possible_locations = [:top, :left, :right, :bottom]
+    Array(locations).each do |location|
+      if possible_locations.include?(location)
+        method_call = "add_#{location.to_s}_border"
+        self.send(method_call, color, width)
+      else
+        puts "You must provide a border location in: #{possible_locations}"
+      end
+    end
+    self
+  end
+  alias :add_border :add_borders
+
+  def remove_borders
+    self.layer.sublayers.copy.each do |layer|
+      layer.removeFromSuperlayer
+    end if self.layer.sublayers
+  end
+  alias :remove_border :remove_borders
+
+  def add_top_border(color, width)
+    add_border_with_frame(color, CGRectMake(0, 0, CGRectGetWidth(self.frame), width))
+  end
+
+  def add_right_border(color, width)
+    add_border_with_frame(color, CGRectMake(CGRectGetWidth(self.frame) - width, 0, width, CGRectGetHeight(self.frame)))
+  end
+
+  def add_bottom_border(color, width)
+    add_border_with_frame(color, CGRectMake(0, CGRectGetHeight(self.frame) - width, CGRectGetWidth(self.frame), width))
+  end
+
+  def add_left_border(color, width)
+    add_border_with_frame(color, CGRectMake(0, 0, width, CGRectGetHeight(self.frame)))
+  end
+
+  def add_border_with_frame(color, frame)
+    color = color.CGColor if color.is_a?(UIColor)
+    border = CALayer.layer.tap do |l|
+      l.backgroundColor = color
+      l.frame = frame
+    end
+    self.layer.addSublayer(border)
+  end
+end

data/lib/project/version.rb

@@ -0,0 +1,3 @@
+module OTGHelpers
+  VERSION = '0.0.5'
+end

metadata

@@ -0,0 +1,65 @@
+--- !ruby/object:Gem::Specification
+name: OTGHelpers
+version: !ruby/object:Gem::Version
+  version: 0.0.5
+platform: ruby
+authors:
+- Mark Rickert
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-10-03 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: A set of class extenstions I commonly use in my applications for RubyMotion.
+email:
+- mjar81@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/OTGHelpers.rb
+- lib/project/ns_string.rb
+- lib/project/ui_image.rb
+- lib/project/ui_label.rb
+- lib/project/ui_view.rb
+- lib/project/version.rb
+homepage: ''
+licenses:
+- MIT
+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.6.6
+signing_key: 
+specification_version: 4
+summary: A set of class extenstions I commonly use in my applications for RubyMotion.
+test_files: []