snapshot 0.0.1.1 → 0.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 802001fbac47af37429a0e62965b9c29aa78cfe3
-  data.tar.gz: d17d242bd26f6cb0bb9878957bede22d50b65274
+  metadata.gz: 2062cd7ffe2f73085accb032e996a17a6bae3366
+  data.tar.gz: 28cece95de94cbcd1ce1b01af91cd49686440799
 SHA512:
-  metadata.gz: 6c2acaa46ca4e429197561b3773d9093ca85f2f637584bb36dd97d1dd01abcd7cd9a152d94a04e8162dee54766cac50dce14e1e14dc98dc6a008567b42590d59
-  data.tar.gz: 869f2fc1953f0c4d852f9f2cce0d22bf66e4cb894253d0cc18a115b657034e59e0f72f028898607666b8c34b5bfad48c97cf2b253f78eee523e5601cbbdd923d
+  metadata.gz: 54f045eba2b950217cb20b701166d3301909217d45f5f13fe7e7379ff6da1c32bffa1fb956148674726a3b6ee73af9dae831d371db4374c904c9d53f817f3e85
+  data.tar.gz: 82935ebf00ecdbab062e4353b69debb8fd6744eccf5fe3364993784f40b2051d2ee8fa39150ec304eeecbab8a730a806786d4174df3827679790f207aed6527f

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 Felix Krause
+
+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,148 @@
+<p align="center">
+    <img src="assets/snapshot.png">
+</p>
+
+Snapshot - Create hundreds of iOS app screenshots
+============
+
+[![Twitter: @KauseFx](https://img.shields.io/badge/contact-@KrauseFx-blue.svg?style=flat)](https://twitter.com/KrauseFx)
+<!-- [![License](http://img.shields.io/badge/license-MIT-green.svg?style=flat)](https://github.com/KrauseFx/deliver/blob/develop/LICENSE)
+[![Gem](https://img.shields.io/gem/v/deliver.svg?style=flat)](http://rubygems.org/gems/deliver)
+[![Build Status](https://img.shields.io/travis/KrauseFx/deliver/master.svg?style=flat)](https://travis-ci.org/KrauseFx/deliver) -->
+
+Taking perfect iOS screenshots is difficult. You usually want them to look the same in **all languages** on **all devices**. 
+
+This easily results in over **300 screenshots** you have to create. 
+
+Uploading them is really easy, using [```deliver```](https://github.com/KrauseFx/deliver).
+
+Follow the developer on Twitter: [@KrauseFx](https://twitter.com/KrauseFx)
+
+
+-------
+[Features](#features) &bull;
+[Installation](#installation) &bull;
+[Quick Start](#quick-start) &bull;
+[Usage](#usage) &bull;
+[Tips](#tips) &bull;
+[Need help?](#need-help)
+
+-------
+
+
+# Features
+- Create hundreds of screenshots in multiple languages on all simulators
+- Configure it once, store the configuration in git
+- Do something else, while the computer takes the screenshots for you
+- Very easy to integrate with ```deliver```
+
+# Installation
+
+Install the gem
+
+    sudo gem install snapshot
+
+Make sure, you have the latest version of the Xcode command line tools installed:
+
+    xcode-select --install
+
+# Quick Start
+
+
+The guide will create all the necessary files for you, using the existing app metadata from iTunes Connect.
+
+- ```cd [your_project_folder]```
+- ```snapshot```
+
+Your screenshots will be stored in ```./screenshots/``` by default.
+
+From now on, you can run ```snapshot``` to create new screenshots of your app.
+
+
+# Usage
+
+Why should you have to remember complicated commands and parameters?
+
+Store your configuration in a text file to easily take screenshots from any computer.
+
+## Snapfile
+
+Create a file called ```Snapfile``` in your project directory.
+Once you created your configuration, just run ```snapshot```.
+
+The ```Snapfile``` may contain the following information (all are optional):
+
+### Simulator Types
+```ruby
+devices([
+  "iPhone 6",
+  "iPhone 6 Plus",
+  "iPhone 5",
+  "iPhone 4s"
+])
+```
+
+### Languages
+
+```ruby
+languages([
+  "en-US",
+  "de-DE",
+  "es-ES"
+])
+```
+
+### Javascript file
+Usually ```snapshot``` automatically finds your JavaScript file. If that's not the case, you can pass the path 
+to your test file.
+```ruby
+js_file './path/file.js'
+```
+
+### Scheme
+To not be asked which scheme to use, just set it like this:
+```ruby
+scheme "Name"
+```
+
+### Project Path
+By default, ```snapshot``` will look for your project in the current directory. If it is located somewhere else, pass your custom path:
+```ruby
+project_path "./my_project/Project.xcworkspace"
+```
+
+### iOS Version
+I'll try to keep the script up to date. If you need to change the iOS version, you can do it like this:
+
+```ruby
+ios_version "9.0"
+```
+
+
+# Tips
+## Available language codes
+```ruby
+["da-DK", "de-DE", "el-GR", "en-AU", "en-CA", "en-GB", "en-US", "es-ES", "es-MX", "fi-FI", "fr-CA", "fr-FR", "id-ID", "it-IT", "ja-JP", "ko-KR", "ms-MY", "nl-NL", "no-NO", "pt-BR", "pt-PT", "ru-RU", "sv-SE", "th-TH", "tr-TR", "vi-VI", "cmn-Hans", "zh_CN", "cmn-Hant"]
+```
+
+## Use a clean status bar
+You can use [SimulatorStatusMagic](https://github.com/shinydevelopment/SimulatorStatusMagic) to clean up the status bar.
+
+## Editing the ```Deliverfile```
+Change syntax highlighting to *Ruby*.
+
+# Need help?
+- If there is a technical problem with ```Snapshot```, submit an issue. Run ```snapshot --trace``` to get the stacktrace.
+- I'm available for contract work - drop me an email: snapshot@felixkrause.at
+
+# License
+This project is licensed under the terms of the MIT license. See the LICENSE file.
+
+# Contributing
+
+1. Create an issue to discuss about your idea
+2. Fork it (https://github.com/KrauseFx/snapshot/fork)
+3. Create your feature branch (`git checkout -b my-new-feature`)
+4. Commit your changes (`git commit -am 'Add some feature'`)
+5. Push to the branch (`git push origin my-new-feature`)
+6. Create a new Pull Request

data/bin/snapshot

@@ -0,0 +1,34 @@
+#!/usr/bin/env ruby
+
+$:.push File.expand_path("../../lib", __FILE__)
+
+require 'snapshot'
+require 'commander/import'
+require 'snapshot/update_checker'
+require 'snapshot/dependency_checker'
+
+HighLine.track_eof = false
+
+
+# Commander
+program :version, Snapshot::VERSION
+program :description, 'CLI for \'Snapshot\' - Automatic taking of screenshots on all simulator types in all languages.'
+program :help, 'Author', 'Felix Krause <krausefx@gmail.com>'
+program :help, 'Website', 'http://felixkrause.at'
+program :help, 'GitHub', 'https://github.com/krausefx/snapshot'
+program :help_formatter, :compact
+
+global_option('--verbose') { $verbose = true }
+
+
+Snapshot::UpdateChecker.verify_latest_version
+
+default_command :run
+
+command :run do |c|
+  c.syntax = 'snapshot'
+  c.description = 'Run the script, to take all the screenshots.'
+  c.action do |args, options|
+    Snapshot::Runner.new.work
+  end
+end

data/lib/snapshot.rb

@@ -0,0 +1,17 @@
+require 'json'
+require 'snapshot/version'
+require 'snapshot/helper'
+require 'snapshot/snapshot_config'
+require 'snapshot/runner'
+require 'snapshot/builder'
+require 'snapshot/snapshot_file'
+require 'snapshot/languages'
+
+require 'pry' # TODO: Remove
+
+# Third Party code
+require 'colored'
+
+module Snapshot
+  # Your code goes here...
+end

data/lib/snapshot/builder.rb

@@ -0,0 +1,68 @@
+require 'snapshot/dependency_checker'
+
+module Snapshot
+  class Builder
+    BUILD_DIR = '/tmp/snapshot'
+
+
+    def initialize
+
+    end
+
+    def build_app
+      raise "Could not find project. Please pass the path to your project using 'project_path'.".red unless SnapshotConfig.shared_instance.project_name
+      command = generate_build_command
+
+      Helper.log.info "Building project '#{SnapshotConfig.shared_instance.project_name}'... this might take some time...".green
+      Helper.log.debug command.yellow
+
+      all_lines = []
+
+      PTY.spawn(command) do |stdin, stdout, pid|
+        stdin.each do |line|
+          all_lines << line
+          begin
+            parse_build_line(line) if line.length > 2
+          rescue Exception => ex
+            Helper.log.fatal all_lines.join("\n")
+            raise ex
+          end
+        end
+      end
+
+      if all_lines.join('\n').include?'** BUILD SUCCEEDED **'
+        Helper.log.info "BUILD SUCCEEDED".green
+        return true
+      else
+        Helper.log.info(all_lines.join(' '))
+        raise "Looks like the build was not successfull."
+      end
+    end
+
+    private
+      def parse_build_line(line)
+        if line.include?"** BUILD FAILED **"
+          raise line
+        end
+      end
+
+      def generate_build_command
+        scheme = SnapshotConfig.shared_instance.scheme
+
+        build_command = (DependencyChecker.xctool_installed? ? 'xctool' : 'xcodebuild')
+        [
+          build_command,
+          "-sdk iphonesimulator#{SnapshotConfig.shared_instance.ios_version}",
+          "CONFIGURATION_BUILD_DIR='#{BUILD_DIR}/build'",
+          "-workspace '#{SnapshotConfig.shared_instance.project_path}'",
+          "-scheme '#{scheme}'",
+          "-configuration Debug",
+          "DSTROOT='#{BUILD_DIR}'",
+          "OBJROOT='#{BUILD_DIR}'",
+          "SYMROOT='#{BUILD_DIR}'",
+          "ONLY_ACTIVE_ARCH=NO",
+          "clean build"
+        ].join(' ')
+      end
+  end
+end

data/lib/snapshot/dependency_checker.rb

@@ -0,0 +1,45 @@
+module Snapshot
+  class DependencyChecker
+    def self.check_dependencies
+      self.check_xcode_select
+      self.check_simulators
+      self.check_xctool
+    end
+
+    def self.check_xcode_select
+      unless `xcode-select -v`.include?"xcode-select version "
+        Helper.log.fatal '#############################################################'
+        Helper.log.fatal "# You have to install the Xcode commdand line tools to use deliver"
+        Helper.log.fatal "# Install the latest version of Xcode from the AppStore"
+        Helper.log.fatal "# Run xcode-select --install to install the developer tools"
+        Helper.log.fatal '#############################################################'
+        raise "Run 'xcode-select --install' and start deliver again"
+      end
+    end
+
+    def self.check_simulators
+      Helper.log.debug "Found #{SnapshotFile.available_devices.count} simulators."
+      if SnapshotFile.available_devices.count < 1
+        Helper.log.fatal '#############################################################'
+        Helper.log.fatal "# You have to add new simulators using Xcode"
+        Helper.log.fatal "# Xcode => Window => Devices"
+        Helper.log.fatal '#############################################################'
+        raise "Create the new simulators and run this script again"
+      end
+    end
+
+    def self.xctool_installed?
+      return `which xctool`.length > 1
+    end
+
+    def self.check_xctool
+      if not self.xctool_installed?
+        Helper.log.error '#############################################################'
+        Helper.log.error "# xctool is recommended to build the apps"
+        Helper.log.error "# Install it using 'brew install xctool'"
+        Helper.log.error "# Falling back to xcode build instead "
+        Helper.log.error '#############################################################'
+      end
+    end
+  end
+end

data/lib/snapshot/helper.rb

@@ -0,0 +1,51 @@
+require 'logger'
+
+module Snapshot
+  class Helper
+
+
+    # Logging happens using this method
+    def self.log
+      if is_test?
+        @@log ||= Logger.new(STDOUT) # don't show any logs when running tests
+      else
+        @@log ||= Logger.new(STDOUT)
+      end
+
+      @@log.formatter = proc do |severity, datetime, progname, msg|
+        string = "#{severity} [#{datetime.strftime('%Y-%m-%d %H:%M:%S.%2N')}]: "
+        second = "#{msg}\n"
+
+        if severity == "DEBUG"
+          string = string.magenta
+        elsif severity == "INFO"
+          string = string.white
+        elsif severity == "WARN"
+          string = string.yellow
+        elsif severity == "ERROR"
+          string = string.red
+        elsif severity == "FATAL"
+          string = string.red.bold
+        end
+
+
+        [string, second].join("")
+      end
+
+      @@log
+    end
+
+    # @return true if the currently running program is a unit test
+    def self.is_test?
+      defined?SpecHelper
+    end
+
+    # @return the full path to the Xcode developer tools of the currently
+    #  running system
+    def self.xcode_path
+      return "" if self.is_test? and not OS.mac?
+      `xcode-select -p`.gsub("\n", '') + "/"
+    end
+
+  end
+end

data/lib/snapshot/languages.rb

@@ -0,0 +1,6 @@
+module Snapshot
+  module Languages
+    # These are all the languages which are available to choose for the simulator
+    ALL_LANGUAGES = ["da-DK", "de-DE", "el-GR", "en-AU", "en-CA", "en-GB", "en-US", "es-ES", "es-MX", "fi-FI", "fr-CA", "fr-FR", "id-ID", "it-IT", "ja-JP", "ko-KR", "ms-MY", "nl-NL", "no-NO", "pt-BR", "pt-PT", "ru-RU", "sv-SE", "th-TH", "tr-TR", "vi-VI", "cmn-Hans", "zh_CN", "cmn-Hant"]
+  end
+end

data/lib/snapshot/runner.rb

@@ -0,0 +1,109 @@
+require 'pty'
+
+module Snapshot
+  class Runner
+    TRACE_DIR = '/tmp/snapshot_traces'
+
+    def initialize
+      Snapshot::DependencyChecker.check_dependencies
+    end
+
+    def work
+      @screenshots_path = './screenshots'
+
+      SnapshotConfig.shared_instance.js_file # to verify the file can be found
+
+      Builder.new.build_app
+
+      SnapshotConfig.shared_instance.devices.each do |device|
+        SnapshotConfig.shared_instance.languages.each do |language|
+
+          begin
+            run_tests(device, language)
+            copy_screenshots(language)
+          rescue Exception => ex
+            Helper.log.error(ex)
+          end
+
+        end
+      end
+    end
+
+    def clean_old_traces
+      FileUtils.rm_rf(TRACE_DIR)
+      FileUtils.mkdir_p(TRACE_DIR)
+    end
+
+
+    def run_tests(device, language)
+      Helper.log.info "Running tests on #{device} in language #{language}".green
+      app_path = Dir.glob("/tmp/snapshot/build/*.app").first
+
+      clean_old_traces
+
+      ENV['SNAPSHOT_LANGUAGE'] = language
+      command = generate_test_command(device, language, app_path)
+      
+      retry_run = false
+
+      lines = []
+      PTY.spawn(command) do |stdin, stdout, pid|
+        stdin.each do |line|
+          lines << line
+          result = parse_test_line(line)
+
+          case result
+            when :retry
+              retry_run = true
+            when :screenshot
+              Helper.log.info "Successfully took screenshot 📱"
+            end
+        end
+      end
+
+      if retry_run
+        Helper.log.error "Instruments tool failed again. Re-trying..."
+        sleep 2 # We need enough sleep... that's an instruments bug
+        run_tests(device, language)
+      end
+    end
+
+    def parse_test_line(line)
+      if line =~ /.*Target failed to run.*/
+        return :retry
+      elsif line.include?"Screenshot captured"
+        return :screenshot
+      elsif line =~ /.*Error: (.*)/
+        raise "UIAutomation Error: #{$1}"
+      elsif line =~ /Instruments Usage Error :(.*)/
+        raise "Instruments Usage Error: #{$1}"
+      elsif line.include?"__NSPlaceholderDictionary initWithObjects:forKeys:count:]: attempt to insert nil object"
+        raise "Looks like something is wrong with the used app. Make sure the build was successful."
+      end
+    end
+
+    def copy_screenshots(language)
+      resulting_path = [@screenshots_path, language].join('/')
+      FileUtils.mkdir_p resulting_path
+      Dir.glob("#{TRACE_DIR}/**/*.png") do |file|
+        FileUtils.cp_r(file, resulting_path + '/')
+      end
+    end
+
+    def generate_test_command(device, language, app_path)
+      script_path = SnapshotConfig.shared_instance.js_file
+
+      [
+        "instruments",
+        "-w '#{device}'",
+        "-D '#{TRACE_DIR}/trace'",
+        "-t 'Automation'",
+        "'#{app_path}'",
+        "-e UIARESULTSPATH '#{TRACE_DIR}'",
+        "-e UIASCRIPT '#{script_path}'",
+        "-AppleLanguages '(#{language})'",
+        "-AppleLocale '#{language}'" 
+      ].join(' ')
+    end
+  end
+end

data/lib/snapshot/snapshot_config.rb

@@ -0,0 +1,113 @@
+module Snapshot
+  class SnapshotConfig
+    
+    # @return (SnapshotFile)
+    attr_accessor :snapshot_file
+
+    # @return (Array) List of simulators to use
+    attr_accessor :devices
+
+    # @return (Array) A list of languages which should be used
+    attr_accessor :languages
+    
+    # @return (String) The iOS version (e.g. 8.1)
+    attr_accessor :ios_version
+
+    # @return (String) The path to the project/workspace
+    attr_accessor :project_path
+
+    # @return (String) The name of a scheme, manually set by the user using the config file
+    attr_accessor :manual_scheme
+
+    # @return (String) The path to the JavaScript file to use
+    attr_accessor :manual_js_file
+
+
+    # A shared singleton
+    def self.shared_instance
+      @@instance ||= SnapshotConfig.new
+    end
+
+    # @param path (String) the path to the config file to use (including the file name)
+    def initialize(path = './Snapfile')
+      set_defaults
+
+      if path and File.exists?path
+        self.snapshot_file = SnapshotFile.new(path, self)
+      else
+        Helper.log.error "Could not find './Snapfile'. It is recommended to create a file into the current directory. Using the defaults now."
+      end
+    end
+
+    def set_defaults
+      self.ios_version = '8.1'
+
+      self.devices = [
+        "iPhone 6 (#{self.ios_version} Simulator)",
+        "iPhone 6 Plus (#{self.ios_version} Simulator)",
+        "iPhone 5 (#{self.ios_version} Simulator)",
+        "iPhone 4S (#{self.ios_version} Simulator)"
+      ]
+
+      self.languages = [
+        'de-DE',
+        'en-US'
+      ]
+
+      self.project_path = (Dir.glob("./*.xcworkspace").first rescue nil)
+      self.project_path ||= (Dir.glob("./*.xcodeproj").first rescue nil)
+    end
+
+    # Getters
+
+    # Returns the file name of the project
+    def project_name
+      (self.project_path.split('/').last.split('.').first rescue nil)
+    end
+
+    # The JavaScript UIAutomation file
+    def js_file
+      files = Dir.glob("./*.js").delete_if { |path| path.include?"SnapshotHelper.js" }
+      if files.count == 1
+        return files.first
+      else
+        raise "Could not determine which UIAutomation file to use. Please pass a path to your Javascript file using 'js_path'.".red
+      end
+    end
+
+    # The scheme to use (either it's set, or there is only one, or user has to enter it)
+    def scheme
+      begin
+        command = "cd '#{project_path.split('/')[0..-2].join('/')}'; xcodebuild -list"
+        schemes = `#{command}`.split("Schemes:").last.split("\n").each { |a| a.strip! }.delete_if { |a| a == '' }
+        Helper.log.debug "Found available schemes: #{schemes}"
+
+
+        if self.manual_scheme
+          if not schemes.include?manual_scheme
+            raise "Could not find requested scheme '#{self.manual_scheme}' in Xcode's schemes #{schemes}"
+          else
+            return self.manual_scheme
+          end
+        else
+          # We have to ask the user first
+          puts "Found the following schemes in your project:".green
+          puts "You can use 'scheme \"Name\"' in your Snapfile".green
+          puts "--------------------------------------------".green
+          while not schemes.include?self.manual_scheme
+            schemes.each_with_index do |current, index|
+              puts "#{index + 1}) #{current}"
+            end
+            val = gets.strip.to_i
+            if val > 0
+              self.manual_scheme = (schemes[val - 1] rescue nil)
+            end
+          end
+          return self.manual_scheme
+        end
+      rescue Exception => ex
+        raise "Could not fetch available schemes: #{ex}".red
+      end
+    end
+  end
+end

data/lib/snapshot/snapshot_file.rb

@@ -0,0 +1,82 @@
+module Snapshot
+  class SnapshotFile
+
+    # @return (String) The path to the used Deliverfile.
+    attr_accessor :path
+
+    # @param path (String) the path to the config file to use (including the file name)
+    def initialize(path, config)
+      raise "Config file not found at path '#{path}'".red unless File.exists?(path.to_s)
+
+      self.path = path
+
+      @config = config
+
+      eval(File.read(self.path))
+    end
+
+    def method_missing(method_sym, *arguments, &block)
+      value = arguments.first || (block.call if block_given?)
+
+      case method_sym
+        when :devices
+          self.verify_devices(value)
+        when :languages
+          self.verify_languages(value)
+        when :ios_version
+          raise "ios_version has to be an String".red unless value.kind_of?String
+          @config.ios_version = value
+        when :scheme
+          raise "scheme has to be an String".red unless value.kind_of?String
+          @config.manual_scheme = value
+        when :js_file
+          raise "js_file has to be an String".red unless value.kind_of?String
+          raise "js_file at path '#{value}' not found".red unless File.exists?value
+          @config.manual_js_file = value
+        when :project_path
+          raise "project_path has to be an String".red unless value.kind_of?String
+
+          if File.exists?value and (value.end_with?".xcworkspace" or value.end_with?".xcodeproj")
+            @config.project_path = value
+          else
+            raise "The given project_path '#{value}' could not be found. Make sure to include the extension as well.".red
+          end
+        else
+          Helper.log.error "Unknown method #{method_sym}"
+        end
+    end
+
+    def verify_devices(value)
+      raise "Devices has to be an array".red unless value.kind_of?Array
+      value.each do |current|
+        current += " (#{@config.ios_version} Simulator)" unless current.include?"Simulator"
+
+        unless SnapshotFile.available_devices.include?current
+          raise "Device '#{current}' not found. Available device types: #{SnapshotFile.available_devices}".red
+        end
+      end
+      @config.devices = value
+    end
+
+    def verify_languages(value)
+      raise "Languages has to be an array".red unless value.kind_of?Array
+      value.each do |current|
+        unless Languages::ALL_LANGUAGES.include?current
+          raise "Language '#{current}' not found. Available languages: #{Languages::ALL_LANGUAGES}".red
+        end
+      end
+      @config.languages = value
+    end
+
+    def self.available_devices
+      if not @result
+        @result = []
+        `instruments -s`.split("\n").each do |current|
+          # Example: "iPhone 5 (8.1 Simulator) [C49ECC4A-5A3D-44B6-B9BF-4E25BC326400]"
+          @result << current.split(' [').first if current.include?"Simulator"
+        end
+      end
+      return @result
+    end
+  end
+end

data/lib/snapshot/update_checker.rb

@@ -0,0 +1,45 @@
+require 'open-uri'
+
+module Snapshot
+  # Verifies, the user runs the latest version of this gem
+  class UpdateChecker
+    # This method will check if the latest version is installed and show a warning if that's not the case
+    def self.verify_latest_version
+      if self.update_available?
+        v = fetch_latest
+        puts '#######################################################################'.green
+        puts "# Snapshot #{v} is available.".green
+        puts "# It is recommended to use the latest version.".green
+        puts "# Update using '(sudo) gem update snapshot'.".green
+        puts "# To see what's new, open https://github.com/KrauseFx/snapshot/releases.".green
+        puts '#######################################################################'.green
+        return true
+      end
+      false
+    end
+
+    # Is a new official release available (this does not include pre-releases)
+    def self.update_available?
+      begin
+        latest = fetch_latest
+        if latest and Gem::Version.new(latest) > Gem::Version.new(current_version)
+          return true
+        end
+      rescue Exception => ex
+        Helper.log.debug(ex)
+        Helper.log.error("Could not check if 'snapshot' is up to date.")
+      end
+      return false
+    end
+
+    # The currently used version of this gem
+    def self.current_version
+      Snapshot::VERSION
+    end
+
+    private
+      def self.fetch_latest
+        JSON.parse(open("http://rubygems.org/api/v1/gems/snapshot.json").read)["version"]
+      end
+  end
+end

data/lib/snapshot/version.rb

@@ -0,0 +1,3 @@
+module Snapshot
+  VERSION = "0.0.2"
+end

metadata

@@ -1,23 +1,191 @@
 --- !ruby/object:Gem::Specification
 name: snapshot
 version: !ruby/object:Gem::Version
-  version: 0.0.1.1
+  version: 0.0.2
 platform: ruby
 authors:
 - Felix Krause
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-11-09 00:00:00.000000000 Z
-dependencies: []
-description: More coming soon
+date: 2014-11-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: highline
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.6.21
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.6.21
+- !ruby/object:Gem::Dependency
+  name: plist
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.1.0
+- !ruby/object:Gem::Dependency
+  name: colored
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: commander
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.2.0
+- !ruby/object:Gem::Dependency
+  name: bundler
+  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'
+- !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'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.1.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.1.0
+- !ruby/object:Gem::Dependency
+  name: pry
+  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'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.8.7.4
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.8.7.4
+- !ruby/object:Gem::Dependency
+  name: codeclimate-test-reporter
+  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: Take the pain out of taking iOS app screenshots.
 email:
 - krausefx@gmail.com
-executables: []
+executables:
+- snapshot
 extensions: []
 extra_rdoc_files: []
-files: []
-homepage: ''
+files:
+- LICENSE
+- README.md
+- bin/snapshot
+- lib/snapshot.rb
+- lib/snapshot/builder.rb
+- lib/snapshot/dependency_checker.rb
+- lib/snapshot/helper.rb
+- lib/snapshot/languages.rb
+- lib/snapshot/runner.rb
+- lib/snapshot/snapshot_config.rb
+- lib/snapshot/snapshot_file.rb
+- lib/snapshot/update_checker.rb
+- lib/snapshot/version.rb
+homepage: http://felixkrause.at
 licenses:
 - MIT
 metadata: {}
@@ -41,6 +209,6 @@ rubyforge_project:
 rubygems_version: 2.2.2
 signing_key: 
 specification_version: 4
-summary: Creates new screenshots from iOS apps for you
+summary: Snapshot - Create hundreds of iOS app screenshots automatically
 test_files: []
 has_rdoc: