motion-mastr 0.2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 2833f7e9ad2ff27188a0dd9a720cb3372f2ed2c3
+  data.tar.gz: 26e8487689649201c36cc45b47c415c99ef9732e
+SHA512:
+  metadata.gz: f596e78fcf9c6e9dae1f8b18dfbf8cf1bb002cbabe2502f3e508244d9aebdaf1aa16fd50ab0fe663516cd8c85c713a9c7a70f2017d4efb659871f7e32d39be11
+  data.tar.gz: b42fab78b38998393917ccc30d623b56288d03783ce8f6a91536efb161a57f8135ce5acf0d3f2c3e6df3d40c40667c67012c39a27c6d19ffffe936f402467146

data/README.md

@@ -0,0 +1,127 @@
+# motion-mastr
+[![Gem Version](https://img.shields.io/gem/v/motion-mastr.svg?style=flat)](https://rubygems.org/gems/motion-mastr)
+[![Build Status](https://img.shields.io/travis/skellock/motion-mastr.svg?style=flat)](https://travis-ci.org/skellock/motion-mastr)
+
+A RubyMotion library for iOS 7+ to own NSMutableAttributedString.
+
+MASTR = Mutable Attributed STRing
+
+<img src="./_pics/mastr.gif" alt="Demo" />
+
+
+# Installation
+
+Add this to your Gemfile:
+
+```ruby
+gem 'motion-mastr'
+```
+
+Then run this to install it:
+
+```
+bundle
+```
+
+# Requirements
+
+* iOS 7 or higher
+
+
+# Usage
+
+```ruby
+include MotionMastr
+```
+
+This is a MastrBuilder.
+```ruby
+mastr # => MastrBuilder
+```
+
+You'll use this to build your `NSMutableAttributeString`s.
+```ruby
+mastr.build # => NSMutableAttributeString
+```
+
+Feed it a string.
+```ruby
+mastr("hello").build
+```
+
+Feed it styles too.
+```ruby
+mastr("Grimace", foreground_color: UIColor.purpleColor).build
+```
+
+Keep adding pieces until you get what you want.
+```ruby
+mastr.add("hi").add("there").add("!").build
+```
+
+Styles inside mastr() are default styles.
+```ruby
+blue = UIColor.blueColor
+mastr("blue", foreground_color: blue).add(" blue ").add(" blue ").build
+```
+
+Override defaults while adding pieces.
+```ruby
+red = UIColor.redColor
+green = UIColor.greenColor
+mastr("red light", foreground_color:red)
+  .add("green light", foreground_color:green)
+  .add("red light")
+  .add("red light")
+  .build
+```
+
+# Supported Styles
+
+```ruby
+alignment                  # :left, :right, :center
+attachment                 # NSTextAttachment
+background_color           # UIColor
+base_writing_direction     # :natural, :left_to_right, :right_to_left
+baseline_offset            # :default or Float
+default_tab_interval       # :default or 0.0 and up
+expansion                  # :default or Float
+first_line_head_indent     # 0.0 and up
+font                       # UIFont
+foreground_color           # UIColor
+head_indent                # 0.0 and up
+hyphenation_factor         # 0.0 up to 1.0
+kern                       # :default, Float
+ligature                   # :off, :on
+line_break_mode            # :word, :char, :clip, :head, :tail, :middle
+line_height_multiple       # :default, 0.0 and up
+line_spacing               # 0.0 and up
+link                       # NSURL or NSString
+maximum_line_height        # :off, 0.0 and up
+minimum_line_height        # :off, 0.0 and up
+obliqueness                # :default, Float
+paragraph_spacing          # :default, 0.0 and up
+paragraph_spacing_before   # :default, 0.0 and up
+shadow_blur_radius         # 0.0 and up
+shadow_color               # UIColor
+shadow_offset              # CGSize, [Float, Float], Float
+strikethrough_color        # UIColor
+strikethrough_style        # :style_none, :style_single, :style_thick, :style_double or an array including those + [:pattern_solid :pattern_dot :pattern_dash :pattern_dash_dot :pattern_dash_dot_dot :by_word]
+stroke_color               # UIColor
+stroke_width               # :default, Float
+tail_indent                # 0.0 and up
+text_effect                # :letterpress
+underline_color            # UIColor
+underline_style            # :style_none, :style_single, :style_thick, :style_double or an array including those + [:pattern_solid :pattern_dot :pattern_dash :pattern_dash_dot :pattern_dash_dot_dot :by_word]
+```
+
+For details, check out the NSAttributedString docs.  Or just play around.
+
+# Wierd Things
+
+* Setting text_effect makes the CPU work hard, not sure why yet.
+* Shadow properties aren't working when assigning to a UILabel, not sure why yet.
+* Go easy on obliqueness, don't get hurt.
+
+
+

data/lib/motion-mastr.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, "motion-mastr/**/*.rb")))
+end

data/lib/motion-mastr/attributes/attachment_attribute.rb

@@ -0,0 +1,15 @@
+module MotionMastr
+  module Attributes
+
+    # NSAttachmentAttributeName
+    #
+    # :attachment = NSTextAttachment
+    #
+    #
+    def attachment_attribute(styles={})
+      return nil if styles.nil?
+      styles[:attachment].is_a?(NSTextAttachment) ? styles[:attachment] : nil
+    end
+
+  end
+end

data/lib/motion-mastr/attributes/background_color_attribute.rb

@@ -0,0 +1,16 @@
+module MotionMastr
+  module Attributes
+
+    # NSBackgroundColorAttributeName
+    #
+    # :background_color = UIColor
+    #
+    def background_color_attribute(styles={})
+      return nil if styles.nil?
+      value = styles[:background_color]
+      return nil unless value && value.is_a?(UIColor)
+      value
+    end
+
+  end
+end

data/lib/motion-mastr/attributes/baseline_offset_attribute.rb

@@ -0,0 +1,20 @@
+module MotionMastr
+  module Attributes
+
+    # NSBaselineOffsetAttributeName
+    #
+    # :baseline_offset
+    #   * 0, :default
+    #   * A Float
+    #
+    def baseline_offset_attribute(styles={})
+      return nil if styles.nil?
+      return nil if styles[:baseline_offset].nil?
+      value = styles[:baseline_offset]
+      return 0 if [0, :default].include?(value)
+      return nil unless value.respond_to?(:to_f)
+      return value.to_f
+    end
+
+  end
+end

data/lib/motion-mastr/attributes/expansion_attribute.rb

@@ -0,0 +1,20 @@
+module MotionMastr
+  module Attributes
+
+    # NSExpansionAttributeName
+    #
+    # :expansion
+    #   * 0, :default
+    #   * A Float
+    #
+    def expansion_attribute(styles={})
+      return nil if styles.nil?
+      return nil if styles[:expansion].nil?
+      value = styles[:expansion]
+      return 0 if [0, :default].include?(value)
+      return nil unless value.respond_to?(:to_f)
+      return value.to_f
+    end
+
+  end
+end

data/lib/motion-mastr/attributes/font_attribute.rb

@@ -0,0 +1,16 @@
+module MotionMastr
+  module Attributes
+
+    # NSFontAttributeName
+    #
+    # :font = UIFont
+    #
+    def font_attribute(styles={})
+      return nil if styles.nil?
+      value = styles[:font]
+      return nil unless value && value.is_a?(UIFont)
+      value
+    end
+
+  end
+end

data/lib/motion-mastr/attributes/foreground_color_attribute.rb

@@ -0,0 +1,16 @@
+module MotionMastr
+  module Attributes
+
+    # NSForegroundColorAttributeName
+    #
+    # :foreground_color = UIColor
+    #
+    def foreground_color_attribute(styles={})
+      return nil if styles.nil?
+      value = styles[:foreground_color]
+      return nil unless value && value.is_a?(UIColor)
+      value
+    end
+
+  end
+end

data/lib/motion-mastr/attributes/kern_attribute.rb

@@ -0,0 +1,19 @@
+module MotionMastr
+  module Attributes
+
+    # NSKernAttributeName
+    #
+    # :kern or :kerning
+    #   * 0, :off, :none, :default
+    #   * A Float
+    #
+    def kern_attribute(styles={})
+      return nil if styles.nil?
+      return unless styles[:kern] || styles[:kerning]
+      value = styles[:kern] || styles[:kerning]
+      return 0 if [0, :off, :none, :default].include?(value)
+      return value.to_f
+    end
+
+  end
+end

data/lib/motion-mastr/attributes/ligature_attribute.rb

@@ -0,0 +1,19 @@
+module MotionMastr
+  module Attributes
+
+    # NSLigatureAttributeName
+    #
+    # :ligature
+    #   = 0, :off, :none
+    #   = 1, :on, :default
+    #
+    def ligature_attribute(styles={})
+      return nil if styles.nil?
+      value = styles[:ligature]
+      return 0 if [0, :off, :none].include?(value)
+      return 1 if [1, :on, :default].include?(value)
+      nil
+    end
+
+  end
+end

data/lib/motion-mastr/attributes/link_attribute.rb

@@ -0,0 +1,16 @@
+module MotionMastr
+  module Attributes
+
+    # NSLinkAttributeName
+    #
+    # :link = NSString or NSURL
+    #
+    #
+    def link_attribute(styles={})
+      return nil if styles.nil?
+      return styles[:link] if styles[:link].is_a?(NSURL) || styles[:link].is_a?(String)
+      nil
+    end
+
+  end
+end

data/lib/motion-mastr/attributes/obliqueness_attribute.rb

@@ -0,0 +1,20 @@
+module MotionMastr
+  module Attributes
+
+    # NSObliquenessAttributeName
+    #
+    # :obliqueness
+    #   * 0, :default
+    #   * A Float
+    #
+    def obliqueness_attribute(styles={})
+      return nil if styles.nil?
+      return nil if styles[:obliqueness].nil?
+      value = styles[:obliqueness]
+      return 0 if [0, :default].include?(value)
+      return nil unless value.respond_to?(:to_f)
+      return value.to_f
+    end
+
+  end
+end

data/lib/motion-mastr/attributes/paragraph_style_attribute.rb

@@ -0,0 +1,221 @@
+module MotionMastr
+  module Attributes
+
+    # NSParagraphStyleAttributeName
+    #
+    # :alignment
+    #    :left, :right, :center, :centered
+    #
+    # :first_line_head_indent
+    #    non-negative Float
+    #
+    # :head_indent
+    #    non-negative Float
+    #
+    # :tail_indent
+    #    non-negative Float
+    #
+    # :line_break_mode
+    #
+    #   :by_word, :by_word_wrap, :by_word_wrapping, :word, :word_wrapping, :word_wrap
+    #   :by_char, :by_char_wrapping, :char
+    #   :clip, :clipping, :by_clipping
+    #   :by_truncating_head, :head
+    #   :by_truncating_tail, :tail
+    #   :by_truncating_middle, :middle
+    #
+    # :maximum_line_height
+    #
+    #    0, :off, :infinite, :none
+    #    or a Float
+    #
+    # :minimum_line_height
+    #
+    #    0, :off, :infinite, :none
+    #    or a Float
+    #
+    # :line_spacing
+    #
+    #    0 or a positive Float
+    #
+    # :paragraph_spacing
+    #
+    #    0 or a positive Float
+    #
+    # :paragraph_spacing_before
+    #
+    #    0, :default
+    #    or a positive Float
+    #
+    # :base_writing_direction
+    #
+    #    :natural, :default
+    #    :left, :left_to_right, :l2r
+    #    :right, :right_to_left, :r2l
+    #
+    # :line_height_multiple
+    #
+    #    0, :default
+    #    or a positive Float
+    #
+    # :default_tab_interval
+    #
+    #   0, :default
+    #   or a positive Float
+    #
+    # :hyphenation_factor
+    #   0, :deffault
+    #   or a positive Float up to 1.0
+    #
+    def paragraph_style_attribute(styles={})
+      return nil if styles.nil?
+
+      # search for valid paragraph-related keys
+      style_keys                 = styles.keys
+      paragraph_related_keys     = [
+        :alignment,
+        :first_line_head_indent,
+        :head_indent,
+        :tail_indent,
+        :line_break_mode,
+        :maximum_line_height,
+        :minimum_line_height,
+        :line_spacing,
+        :paragraph_spacing,
+        :paragraph_spacing_before,
+        :base_writing_direction,
+        :line_height_multiple,
+        :default_tab_interval,
+        :hyphenation_factor,
+      ]
+      contains_paragraph_styling = (style_keys - paragraph_related_keys).length != style_keys.length
+      return nil unless contains_paragraph_styling
+
+      # start with logical defaults
+      paragraph = NSParagraphStyle.defaultParagraphStyle.mutableCopy
+
+      # alignment
+      if styles[:alignment]
+        case styles[:alignment]
+        when :right then paragraph.alignment = NSTextAlignmentRight
+        when :center, :centered, :centre, :centred then paragraph.alignment = NSTextAlignmentCenter
+        when :left then paragraph.alignment = NSTextAlignmentLeft
+        end
+      end
+
+      # first line head indent
+      if styles[:first_line_head_indent]
+        indent = styles[:first_line_head_indent].to_f
+        indent = 0 if indent < 0
+        paragraph.firstLineHeadIndent = indent
+      end
+
+      # head indent
+      if styles[:head_indent]
+        indent = styles[:head_indent].to_f
+        indent = 0 if indent < 0
+        paragraph.headIndent = indent
+      end
+
+      # tail indent
+      if styles[:tail_indent]
+        indent = styles[:tail_indent].to_f
+        indent = 0 if indent < 0
+        paragraph.tailIndent = indent
+      end
+
+      # line break mode
+      if styles[:line_break_mode]
+        case styles[:line_break_mode]
+        when :by_word, :by_word_wrap, :by_word_wrapping, :word, :word_wrapping, :word_wrap then paragraph.lineBreakMode = NSLineBreakByWordWrapping
+        when :by_char, :by_char_wrapping, :char then paragraph.lineBreakMode = NSLineBreakByCharWrapping
+        when :clip, :clipping, :by_clipping then paragraph.lineBreakMode = NSLineBreakByClipping
+        when :by_truncating_head, :head then paragraph.lineBreakMode = NSLineBreakByTruncatingHead
+        when :by_truncating_tail, :tail then paragraph.lineBreakMode = NSLineBreakByTruncatingTail
+        when :by_truncating_middle, :middle then paragraph.lineBreakMode = NSLineBreakByTruncatingMiddle
+        end
+      end
+
+      # maximum line height
+      if styles[:maximum_line_height]
+        maximum_line_height = styles[:maximum_line_height]
+        maximum_line_height = 0 if [:off, :infinite, 0, :none].include?(maximum_line_height)
+        maximum_line_height ||= maximum_line_height.to_f
+        maximum_line_height = 0 if maximum_line_height < 0
+        paragraph.maximumLineHeight = maximum_line_height
+      end
+
+      # minimum line height
+      if styles[:minimum_line_height]
+        minimum_line_height = styles[:minimum_line_height]
+        minimum_line_height = 0 if [:off, :infinite, 0, :none].include?(minimum_line_height)
+        minimum_line_height ||= minimum_line_height.to_f
+        minimum_line_height = 0 if minimum_line_height < 0
+        paragraph.minimumLineHeight = minimum_line_height
+      end
+
+      # line spacing
+      if styles[:line_spacing]
+        line_spacing = styles[:line_spacing].to_f
+        line_spacing = 0 if line_spacing < 0
+        paragraph.lineSpacing = line_spacing
+      end
+
+      # paragraph spacing
+      if styles[:paragraph_spacing]
+        paragraph_spacing = styles[:paragraph_spacing].to_f
+        paragraph_spacing = 0 if paragraph_spacing < 0
+        paragraph.paragraphSpacing = paragraph_spacing
+      end
+
+      # paragraph spacing before
+      if styles[:paragraph_spacing_before]
+        paragraph_spacing_before = styles[:paragraph_spacing_before]
+        paragraph_spacing_before = 0 if [0, :default].include?(paragraph_spacing_before)
+        paragraph_spacing_before ||= styles[:paragraph_spacing_before].to_f
+        paragraph_spacing_before = 0 if paragraph_spacing_before < 0
+        paragraph.paragraphSpacingBefore = paragraph_spacing_before
+      end
+
+      # base writing direction
+      if styles[:base_writing_direction]
+        case styles[:base_writing_direction]
+        when :natural, :default then paragraph.baseWritingDirection = NSWritingDirectionNatural
+        when :left, :left_to_right, :l2r then paragraph.baseWritingDirection = NSWritingDirectionLeftToRight
+        when :right, :right_to_left, :r2l then paragraph.baseWritingDirection = NSWritingDirectionRightToLeft
+        end
+      end
+
+      # line height multiple
+      if styles[:line_height_multiple]
+        line_height_multiple = styles[:line_height_multiple]
+        line_height_multiple = 0 if [0, :default].include?(line_height_multiple)
+        line_height_multiple ||= styles[:line_height_multiple].to_f
+        line_height_multiple = 0 if line_height_multiple < 0
+        paragraph.lineHeightMultiple = line_height_multiple
+      end
+
+      # default tab interval
+      if styles[:default_tab_interval]
+        default_tab_interval = styles[:default_tab_interval]
+        default_tab_interval = 0 if [0, :default].include?(default_tab_interval)
+        default_tab_interval ||= styles[:default_tab_interval].to_f
+        default_tab_interval = 0 if default_tab_interval < 0
+        paragraph.defaultTabInterval = default_tab_interval
+      end
+
+      # hyphenation factor
+      if styles[:hyphenation_factor]
+        hyphenation_factor = styles[:hyphenation_factor]
+        hyphenation_factor = 0 if [0, :default].include?(hyphenation_factor)
+        hyphenation_factor ||= styles[:hyphenation_factor].to_f
+        hyphenation_factor = 0 if hyphenation_factor < 0
+        hyphenation_factor = 1.0 if hyphenation_factor > 1
+        paragraph.hyphenationFactor = hyphenation_factor
+      end
+
+      paragraph
+    end
+
+  end
+end

data/lib/motion-mastr/attributes/shadow_attribute.rb

@@ -0,0 +1,51 @@
+module MotionMastr
+  module Attributes
+
+    # NSShadowAttributeName
+    #
+    # :shadow_offset
+    #    CGSize
+    #
+    def shadow_attribute(styles={})
+      return nil if styles.nil?
+
+      # search for valid shadow-related keys
+      style_keys = styles.keys
+      shadow_keys = [:shadow_offset, :shadow_blur_radius, :shadow_color]
+      contains_shadow_styling = (style_keys - shadow_keys).length != style_keys.length
+      return nil unless contains_shadow_styling
+
+      # create our shadow
+      shadow = NSShadow.alloc.init
+
+      # offset
+      if styles[:shadow_offset]
+        offset = styles[:shadow_offset]
+        if offset.is_a? CGSize
+          shadow.shadowOffset = offset
+        elsif offset.is_a? Array
+          shadow.shadowOffset = offset if offset.length == 2
+        elsif offset.is_a? Fixnum
+          shadow.shadowOffset = [offset, offset]
+        elsif offset.is_a? Float
+          shadow.shadowOffset = [offset, offset]
+        end
+      end
+
+      # blur
+      if styles[:shadow_blur_radius]
+        blur = styles[:shadow_blur_radius]
+        blur = 0 if [0, :default, :none, :off].include?(blur)
+        blur ||= blur.to_f
+        blur = 0 if blur < 0
+        shadow.shadowBlurRadius = blur
+      end
+
+      # color
+      shadow.shadowColor = styles[:shadow_color] if styles[:shadow_color].is_a? UIColor
+
+      shadow
+    end
+
+  end
+end

data/lib/motion-mastr/attributes/strikethrough_color_attribute.rb

@@ -0,0 +1,16 @@
+module MotionMastr
+  module Attributes
+
+    # NSStrikethroughColorAttributeName
+    #
+    # :strikethrough_color = UIColor
+    #
+    def strikethrough_color_attribute(styles={})
+      return nil if styles.nil?
+      value = styles[:strikethrough_color]
+      return nil unless value && value.is_a?(UIColor)
+      value
+    end
+
+  end
+end

data/lib/motion-mastr/attributes/strikethrough_style_attribute.rb

@@ -0,0 +1,22 @@
+module MotionMastr
+  module Attributes
+
+    # NSStrikethroughStyleAttribute
+    #
+    # :strikethrough_style is either a Symbol or Array of symbols which will be OR'd together
+    #
+    def strikethrough_style_attribute(styles={})
+      return nil if styles.nil?
+      value = styles[:strikethrough_style]
+      return underline_style_value(value) if value.is_a? Symbol
+      if value.is_a? Array
+        bitsauce = 0
+        value.each { |s| bitsauce |= underline_style_value(s) }
+        bitsauce
+      else
+        nil
+      end
+    end
+
+  end
+end

data/lib/motion-mastr/attributes/stroke_color_attribute.rb

@@ -0,0 +1,16 @@
+module MotionMastr
+  module Attributes
+
+    # NSStrokeColorAttributeName
+    #
+    # :stroke_color = UIColor
+    #
+    def stroke_color_attribute(styles={})
+      return nil if styles.nil?
+      value = styles[:stroke_color]
+      return nil unless value && value.is_a?(UIColor)
+      value
+    end
+
+  end
+end

data/lib/motion-mastr/attributes/stroke_width_attribute.rb

@@ -0,0 +1,20 @@
+module MotionMastr
+  module Attributes
+
+    # NSStrokeWidthAttributeName
+    #
+    # :stroke_width
+    #   * 0, :default
+    #   * A Float
+    #
+    def stroke_width_attribute(styles={})
+      return nil if styles.nil?
+      return nil if styles[:stroke_width].nil?
+      value = styles[:stroke_width]
+      return 0 if [0, :default].include?(value)
+      return nil unless value.respond_to?(:to_f)
+      return value.to_f
+    end
+
+  end
+end

data/lib/motion-mastr/attributes/text_effect_attribute.rb

@@ -0,0 +1,15 @@
+module MotionMastr
+  module Attributes
+
+    # NSTextEffectAttributeName
+    #
+    # :text_effect = :symbol
+    #
+    def text_effect_attribute(styles={})
+      return nil if styles.nil?
+      return NSTextEffectLetterpressStyle if [:letterpress, :letterpress_style].include?(styles[:text_effect])
+      nil
+    end
+
+  end
+end

data/lib/motion-mastr/attributes/underline_color_attribute.rb

@@ -0,0 +1,16 @@
+module MotionMastr
+  module Attributes
+
+    # NSUnderlineColorAttributeName
+    #
+    # :underline_color = UIColor
+    #
+    def underline_color_attribute(styles={})
+      return nil if styles.nil?
+      value = styles[:underline_color]
+      return nil unless value && value.is_a?(UIColor)
+      value
+    end
+
+  end
+end

data/lib/motion-mastr/attributes/underline_style_attribute.rb

@@ -0,0 +1,22 @@
+module MotionMastr
+  module Attributes
+
+    # NSUnderlineStyleAttribute
+    #
+    # :underline_style is either a Symbol or Array of symbols which will be OR'd together
+    #
+    def underline_style_attribute(styles={})
+      return nil if styles.nil?
+      value = styles[:underline_style]
+      return underline_style_value(value) if value.is_a? Symbol
+      if value.is_a? Array
+        bitsauce = 0
+        value.each { |s| bitsauce |= underline_style_value(s) }
+        bitsauce
+      else
+        nil
+      end
+    end
+
+  end
+end

data/lib/motion-mastr/attributes/underline_style_helper.rb

@@ -0,0 +1,21 @@
+module MotionMastr
+  module Attributes
+
+    def underline_style_value(value)
+      case value
+      when :style_none, :none then NSUnderlineStyleNone
+      when :style_single, :single then NSUnderlineStyleSingle
+      when :style_thick, :thick then NSUnderlineStyleThick
+      when :style_double, :double then NSUnderlineStyleDouble
+      when :pattern_solid, :solid then NSUnderlinePatternSolid
+      when :pattern_dot, :dot then NSUnderlinePatternDot
+      when :pattern_dash, :dash then NSUnderlinePatternDash
+      when :pattern_dash_dot, :dash_dot then NSUnderlinePatternDashDot
+      when :pattern_dash_dot_dot, :dash_dot_dot then NSUnderlinePatternDashDotDot
+      when :by_word then NSUnderlineByWord
+      else NSUnderlineStyleNone
+      end
+    end
+
+  end
+end

data/lib/motion-mastr/mastr.rb

@@ -0,0 +1,15 @@
+module MotionMastr
+
+  # make a MastrBuilder
+  def mastr(text=nil, default_styles={})
+    b = MastrBuilder.new default_styles
+    b.add text
+    b
+  end
+
+  # make and build a NSMutableAttributedString
+  def mastr!(text=nil, default_styles={})
+    mastr(text, default_styles).build
+  end
+
+end

data/lib/motion-mastr/mastr_builder.rb

@@ -0,0 +1,86 @@
+module MotionMastr
+  class MastrBuilder
+
+    include Attributes
+
+    attr_reader :default_styles, :pieces
+
+    ATTRIBUTES = {
+      font_attribute:                NSFontAttributeName,
+      foreground_color_attribute:    NSForegroundColorAttributeName,
+      background_color_attribute:    NSBackgroundColorAttributeName,
+      stroke_color_attribute:        NSStrokeColorAttributeName,
+      strikethrough_color_attribute: NSStrikethroughColorAttributeName,
+      underline_color_attribute:     NSUnderlineColorAttributeName,
+      ligature_attribute:            NSLigatureAttributeName,
+      kern_attribute:                NSKernAttributeName,
+      paragraph_style_attribute:     NSParagraphStyleAttributeName,
+      strikethrough_style_attribute: NSStrikethroughStyleAttributeName,
+      underline_style_attribute:     NSUnderlineStyleAttributeName,
+      stroke_width_attribute:        NSStrokeWidthAttributeName,
+      shadow_attribute:              NSShadowAttributeName,
+      text_effect_attribute:         NSTextEffectAttributeName,
+      attachment_attribute:          NSAttachmentAttributeName,
+      link_attribute:                NSLinkAttributeName,
+      baseline_offset_attribute:     NSBaselineOffsetAttributeName,
+      obliqueness_attribute:         NSObliquenessAttributeName,
+      expansion_attribute:           NSExpansionAttributeName,
+    }
+
+    def initialize(default_styles={})
+      @default_styles = default_styles || {}
+      @pieces = []
+    end
+
+    # write to default styles
+    def []=(key, value)
+      @default_styles[key] = value
+    end
+
+    # read from default styles
+    def [](key)
+      @default_styles[key]
+    end
+
+    # add a piece of text and optional styles
+    def add(text, styles={})
+      @pieces << {text: text, styles: styles} unless text.nil?
+      self
+    end
+
+    def build
+      # weld up the text pieces
+      text = @pieces.map { |p| p[:text] }.join
+
+      # compose a attribute string
+      result = NSMutableAttributedString.alloc.initWithString(text)
+
+      # style it with the default styles
+      apply_attributes result, 0, text.length, @default_styles
+
+      # apply the styles from the pieces
+      idx = 0
+      @pieces.each do |piece|
+        apply_attributes result, idx, piece[:text].length, piece[:styles]
+        idx += piece[:text].length
+      end
+
+      result
+    end
+
+    # applies styles in a range to the attributed string
+    def apply_attributes(attributed_string, start, length, styles)
+      return unless attributed_string && start && length && styles # sanity
+      return unless start >= 0 && length > 0 && styles.length > 0  # minimums
+      return unless start + length <= attributed_string.length     # maximums
+
+      range = [start, length]
+
+      ATTRIBUTES.each_pair do |method_name, attribute_name|
+        value = send method_name, styles
+        attributed_string.addAttribute(attribute_name, value: value, range: range) if value
+      end
+    end
+
+  end
+end

data/lib/motion-mastr/version.rb

@@ -0,0 +1,3 @@
+module MotionMastr
+  VERSION = "0.2.0" unless defined?(MotionMastr::VERSION)
+end

metadata

@@ -0,0 +1,83 @@
+--- !ruby/object:Gem::Specification
+name: motion-mastr
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+platform: ruby
+authors:
+- Steve Kellock
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-05-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+description: Get your NSMutableAttributedString on!
+email:
+- steve@kellock.ca
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/motion-mastr.rb
+- lib/motion-mastr/attributes/attachment_attribute.rb
+- lib/motion-mastr/attributes/background_color_attribute.rb
+- lib/motion-mastr/attributes/baseline_offset_attribute.rb
+- lib/motion-mastr/attributes/expansion_attribute.rb
+- lib/motion-mastr/attributes/font_attribute.rb
+- lib/motion-mastr/attributes/foreground_color_attribute.rb
+- lib/motion-mastr/attributes/kern_attribute.rb
+- lib/motion-mastr/attributes/ligature_attribute.rb
+- lib/motion-mastr/attributes/link_attribute.rb
+- lib/motion-mastr/attributes/obliqueness_attribute.rb
+- lib/motion-mastr/attributes/paragraph_style_attribute.rb
+- lib/motion-mastr/attributes/shadow_attribute.rb
+- lib/motion-mastr/attributes/strikethrough_color_attribute.rb
+- lib/motion-mastr/attributes/strikethrough_style_attribute.rb
+- lib/motion-mastr/attributes/stroke_color_attribute.rb
+- lib/motion-mastr/attributes/stroke_width_attribute.rb
+- lib/motion-mastr/attributes/text_effect_attribute.rb
+- lib/motion-mastr/attributes/underline_color_attribute.rb
+- lib/motion-mastr/attributes/underline_style_attribute.rb
+- lib/motion-mastr/attributes/underline_style_helper.rb
+- lib/motion-mastr/mastr.rb
+- lib/motion-mastr/mastr_builder.rb
+- lib/motion-mastr/version.rb
+homepage: https://github.com/skellock/motion-mastr
+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.4.5
+signing_key: 
+specification_version: 4
+summary: A RubyMotion library for iOS 7+ to own NSMutableAttributedString.
+test_files: []