motion-smarticons 0.1

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2013 Clay Allsopp (http://clayallsopp.com/)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,61 @@
+# motion-smarticons
+
+motion-smarticons lets you overlay information text like commit hash and version number on top of RubyMotion app icons:
+
+![Default smarticons](http://i.imgur.com/Is0Cc9i.png)
+
+## Installation
+
+- `gem install motion-smarticons`
+- `require 'motion-smarticons'`
+
+or add it to your `Gemfile`:
+
+- `gem 'motion-smarticons'`
+
+## Usage
+
+Add the smarticons commands at the end of your `Motion::Project::App.setup` block to ensure your icons and app info is finalized before generating the new icons.
+
+By default, smarticons will display the `app.version` and latest commit hash, using the `#smarticons!` method:
+
+```ruby
+Motion::Project::App.setup do |app|
+  # ...
+
+  app.smarticons!
+end
+```
+
+![Default smarticons](http://i.imgur.com/GPgwZRv.png)
+
+If you want to display a custom string, simply use `#smarticons=`:
+
+```ruby
+Motion::Project::App.setup do |app|
+  # ...
+
+  app.smarticons = "Hello World"
+end
+```
+
+![Custom smarticons](http://i.imgur.com/v5lDmDq.png)
+
+## Gotchas
+
+iOS will cache old app icons, even after a clean build. If your icon hasn't updated, move it in and out of a folder to update it to the latest version.
+
+## Credits
+
+Shoutout to [@merowing_](http://twitter.com/merowing_) for his article on [generating app icons](http://www.merowing.info/2013/03/overlaying-application-version-on-top-of-your-icon).
+
+## Contact
+
+Clay Allsopp ([http://clayallsopp.com](http://clayallsopp.com))
+
+- [http://twitter.com/clayallsopp](http://twitter.com/clayallsopp)
+- [clay@usepropeller.com](clay@usepropeller.com)
+
+## License
+
+motion-smarticons is available under the MIT license. See the LICENSE file for more info.

data/lib/motion-smarticons.rb

@@ -0,0 +1 @@
+require 'motion/project/smarticons'

data/lib/motion/project/smarticons.rb

@@ -0,0 +1,77 @@
+unless defined?(Motion::Project::Config)
+  raise "This file must be required within a RubyMotion project Rakefile."
+end
+
+require 'RMagick'
+
+class SmartIconsConfig
+  attr_accessor :text
+
+  def initialize(config)
+    @config = config
+  end
+
+  def build!
+    create_icons
+  end
+
+  def text
+    return @text if @text
+
+    default_text
+  end
+
+  def default_text
+    commit = `git rev-parse --short HEAD`.strip
+    branch=`git rev-parse --abbrev-ref HEAD`
+    app_version = @config.version
+    "#{app_version} #{branch} #{commit}"
+  end
+
+  private
+  def create_icons
+    icons = @config.icons
+    files = icons.map {|i|
+      [File.join(@config.resources_dirs, i),
+        File.join(@config.resources_dirs, "_smart_#{i}")]
+    }
+
+    files.each do |file, new_file|
+      icon = Magick::ImageList.new.from_blob(open(file) {|f| f.read}) {
+        self.gravity = Magick::SouthGravity
+      }.first
+
+      caption = Magick::Image.read("caption:#{self.text}") {
+        self.fill = "white"
+        self.background_color = "#0008"
+        height = (icon.rows * 0.35).to_i
+        self.size = "#{icon.columns}x#{height}"
+        self.gravity = Magick::CenterGravity
+      }.first
+
+      new_icon = icon.composite(caption, Magick::SouthGravity, 0, 0, Magick::AtopCompositeOp)
+
+      new_icon.write(new_file)
+    end
+
+    @config.icons = files.map {|f| File.split(f.last)[-1]}
+  end
+end
+
+module Motion; module Project; class Config
+  def smarticons!
+    @smarticons ||= SmartIconsConfig.new(self)
+    @smarticons.build!
+  end
+
+  def smarticons
+    @smarticons ||= SmartIconsConfig.new(self)
+  end
+
+  def smarticons=(string)
+    @smarticons ||= SmartIconsConfig.new(self)
+    @smarticons.text = string
+    @smarticons.build!
+  end
+
+end; end; end

metadata

@@ -0,0 +1,71 @@
+--- !ruby/object:Gem::Specification
+name: motion-smarticons
+version: !ruby/object:Gem::Version
+  version: '0.1'
+  prerelease: 
+platform: ruby
+authors:
+- Clay Allsopp
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-03-09 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rmagick
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.13'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.13'
+description: motion-smarticons lets you overlay informational text like commit hash
+  and version number on top of RubyMotion app icons
+email: clay.allsopp@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- LICENSE
+- lib/motion/project/smarticons.rb
+- lib/motion-smarticons.rb
+homepage: https://github.com/clayallsopp/motion-smarticons
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -86646653972963520
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -86646653972963520
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: Automatically generate icon labels for RubyMotion apps
+test_files: []