appium_thor 0.0.4

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: d682101a6cfd4a4967443f57f1cfb94928cbeb22
+  data.tar.gz: 4788966e9edd1c2dc21e60358bb0354a49baf07e
+SHA512:
+  metadata.gz: 54f4ccf0888fb75511c6d2d4f39983643b54932d82f24eb227af3a15dbdba990687fab879b6ac553ecf2f7d2a6a5bda018881468490cc31b80640e5923896472
+  data.tar.gz: d8c804a24737dd3200aa8ffa8676b4b1bbcf30c657374c13f2ce0bdc95e0001f18d0ab5b94a521eb04a80d76bffbd9f232f7801e9e9cc1b8d10bcc90ca062f51

data/.gitignore

@@ -0,0 +1,37 @@
+.DS_Store
+*.lock
+.id*
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalisation:
+/.bundle/
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+# Gemfile.lock
+# .ruby-version
+# .ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc

data/Gemfile

@@ -0,0 +1,2 @@
+source 'https://rubygems.org'
+gemspec

data/LICENSE

@@ -0,0 +1,201 @@
+Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "{}"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright {yyyy} {name of copyright owner}
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

data/README.md

@@ -0,0 +1,33 @@
+# appium_thor
+
+Appium Thor helpers for appium's gems (appium_lib, appium_capybara)
+
+--
+
+Example configuration
+
+```ruby
+Appium::Thor::Config.set do
+  gem_name 'appium_lib'
+  github_name 'ruby_lib'
+  version_file 'path/to/version.rb'
+end
+```
+
+Available tasks
+
+```
+thor build      # Build a new gem (same as gem task)
+thor bump       # Bump the z version number and update the date
+thor bumpx      # Bump the x version number, set y & z to zero, update the ...
+thor bumpy      # Bump the y version number, set z to zero, update the date
+thor byte       # Remove non-ascii bytes
+thor dev        # Install gems required for release task
+thor docs       # Update android and iOS docs
+thor gem        # Build a new gem
+thor install    # Install gem
+thor notes      # Update release notes
+thor publish    # Build and release a new gem to rubygems.org (same as rele...
+thor release    # Build and release a new gem to rubygems.org
+thor uninstall  # Uninstall gem
+```

data/Thorfile

@@ -0,0 +1,7 @@
+require File.expand_path '../lib/appium_thor', __FILE__
+
+Appium::Thor::Config.set do
+  gem_name     'appium_thor'
+  github_name  'appium_thor'
+  version_file 'lib/appium_thor/version.rb'
+end

data/appium_thor.gemspec

@@ -0,0 +1,22 @@
+require_relative 'lib/appium_thor/version'
+
+Gem::Specification.new do |s|
+  # 1.8.x is not supported
+  s.required_ruby_version = '>= 1.9.3'
+
+  s.name          = 'appium_thor'
+  s.version       = Appium::Thor::VERSION
+  s.date          = Appium::Thor::DATE
+  s.license       = 'http://www.apache.org/licenses/LICENSE-2.0.txt'
+  s.description   = s.summary = 'Thor tasks for Appium gems'
+  s.description   += '.' # avoid identical warning
+  s.authors       = s.email = ['code@bootstraponline.com']
+  s.homepage      = 'https://github.com/appium/appium_thor'
+  s.require_paths = ['lib']
+
+  s.add_runtime_dependency 'redcarpet', '~> 3.1.2'
+  s.add_runtime_dependency 'posix-spawn', '~> 0.3', '>= 0.3.8'
+  s.add_runtime_dependency 'yard', '~> 0.8', '>= 0.8.7.4'
+
+  s.files = `git ls-files`.split "\n"
+end

data/lib/appium_thor/commands/commands.rb

@@ -0,0 +1,70 @@
+require_relative 'init'
+
+# Define Thor tasks in the top level Default namespace.
+class Default < Thor
+  desc 'info', 'prints config info for this gem'
+  def info
+    puts "    gem_name: #{gem_name}\n"    +
+         " github_name: #{github_name}\n" +
+         "version_file: #{version_file}"
+  end
+
+  desc 'bumpx', 'Bump the x version number, set y & z to zero, update the date.'
+  def bumpx
+    _bump :x
+  end
+
+  desc 'bumpy', 'Bump the y version number, set z to zero, update the date.'
+  def bumpy
+    _bump :y
+  end
+
+  desc 'bump', 'Bump the z version number and update the date.'
+  def bump
+    _bump :z
+  end
+
+  desc 'publish', 'Build and release a new gem to rubygems.org'
+  def publish
+    _publish
+  end
+
+  desc 'release', 'Build and release a new gem to rubygems.org (same as publish)'
+  def release
+    _publish
+  end
+
+  desc 'build', 'Build a new gem'
+  def build
+    _build_gem
+  end
+
+  # uninstall is a reserved task name
+  # https://github.com/erikhuda/thor/issues/428
+  desc 'gem_uninstall', 'Uninstall gem'
+  def gem_uninstall
+    _uninstall
+  end
+
+  # install is a reserved task name
+  # https://github.com/erikhuda/thor/issues/428
+  desc 'gem_install', 'Install gem'
+  def gem_install
+    _install
+  end
+
+  desc 'docs', 'Update android and iOS docs'
+  def docs
+    docks_block.call if docs_block
+  end
+
+  desc 'notes', 'Update release notes'
+  def notes
+    update_release_notes
+  end
+
+  desc 'byte', 'Remove non-ascii bytes'
+  def byte
+    remove_non_ascii_from_cwd
+  end
+end

data/lib/appium_thor/commands/init.rb

@@ -0,0 +1,17 @@
+# Define Thor tasks in the top level Default namespace.
+class Default < Thor
+  extend Forwardable
+  include Appium::Thor::Helpers
+  include Appium::Thor::Docs
+
+  # For each possible option method, delegate calls to the config instance
+  no_commands do
+    def_delegators(:@cfg, *Appium::Thor::Config.options)
+  end
+
+  def initialize(args = [], options = {}, config = {})
+    super
+    # Aquire reference to the config defined in the Thorfile
+    @cfg = Appium::Thor::Config.instance
+  end
+end

data/lib/appium_thor/config.rb

@@ -0,0 +1,60 @@
+module Appium
+  module Thor
+    class Config
+      include Singleton
+
+      # Returns true if all options are truthy
+      def validate
+        raise 'Must set gem_name, github_name, version_file' unless @gem_name && @github_name && @version_file
+        raise "version file doesn't exist #{@version_file}" unless File.exist?(@version_file)
+      end
+
+      # Returns option value if it's set otherwise
+      # sets the option value to string
+      def gem_name string=nil
+        return @gem_name if @gem_name
+        @gem_name = string
+      end
+
+      # Returns option value if it's set otherwise
+      # sets the option value to string
+      def github_name string=nil
+        return @github_name if @github_name
+        @github_name = string
+      end
+
+      # Returns option value if it's set otherwise
+      # sets the option value to string
+      def version_file string=nil
+        return @version_file if @version_file
+        @version_file = string
+      end
+
+      # block of code to execute that contains documentation
+      # generation logic
+      def docs_block &block
+        return @docs_block if @docs_block
+        @docs_block = block
+      end
+
+      # all config.rb options as a symbol array
+      def self.options
+        %w[gem_name github_name version_file docs_block].map(&:to_sym)
+      end
+
+      # Enables setting config in the Thorfile
+      #
+      # Appium::Thor::Config.set do
+      #   gem_name     'appium_thor'
+      #   github_name  'appium_thor'
+      #   version_file 'path/to/version.rb'
+      # end
+      def self.set &block
+        config = self.instance
+        config.instance_eval &block
+        config.validate
+        config
+      end
+    end # module Config
+  end # module Thor
+end # module Appium

data/lib/appium_thor/docs.rb

@@ -0,0 +1,90 @@
+module Appium
+  module Thor
+    module Docs
+      def space amount
+        ' ' * amount
+      end
+
+      def last_sha
+        `git rev-parse --verify HEAD`.strip
+      end
+
+      def mobj_to_md obj
+        out = ''
+        # skip objects without method signatures
+        sig = obj.signature
+        return out unless sig
+
+        # skip class vars
+        if sig.start_with?('@@') ||
+          # skip methods marked private
+          obj.tag('private') ||
+          # skip date and version from version.rb
+          obj.name.match(/DATE|VERSION/)
+          return out
+        end
+
+        method_path = obj.file.split('/lib/').last
+        os          = method_path.downcase.match /ios|android/
+        out         += "##### [#{obj.name.to_s}](https://github.com/appium/ruby_lib/blob/#{last_sha}/lib/#{method_path}#L#{obj.line}) #{os}\n\n"
+        out         += "> #{obj.signature}\n\n"
+        out         += "#{obj.docstring}\n\n"
+
+
+        indent = space 5
+        params = obj.tags.select { |tag| tag.tag_name == 'param' }
+        if !params.empty?
+          out += "__Parameters:__\n\n"
+          params.each do |param|
+            out += indent + "[#{param.types.join ', '}] "
+            out += "#{param.name} - #{param.text}\n\n"
+          end
+        end
+
+        ret = obj.tag 'return'
+        if ret
+          out += "__Returns:__\n\n"
+          out += indent + "[#{ret.types.join ', '}] #{ret.text}\n\n"
+        end
+        out += "--\n\n"
+
+        out
+      end
+
+      def run out_file, globs
+        YARD::Registry.clear
+        puts "Globbing: #{globs}"
+        puts "Writing: #{out_file}"
+        YARD::Parser::SourceParser.parse globs
+        File.open(out_file, 'w') do |file|
+          entries        = YARD::Registry.entries
+          entries_length = entries.length
+          puts "Processing: #{entries_length} entries"
+          raise 'No entries to process' if entries_length <= 0
+          YARD::Registry.entries.each do |entry|
+            file.write mobj_to_md entry
+          end
+        end
+
+        raise 'Empty file generated' if File.size(out_file) <= 0
+      end
+
+      def globs paths
+        # Convert single string to array for map
+        paths = [paths] unless paths.kind_of? Array
+        # Adjust path based on system
+        paths.map! { |path| "#{Dir.pwd}#{path}" }
+      end
+
+=begin
+common_globs  = '/lib/appium_lib/*.rb', '/lib/appium_lib/device/*.rb', '/lib/appium_lib/common/**/*.rb'
+android_globs = common_globs + ['/lib/appium_lib/android/**/*.rb']
+ios_globs     = common_globs + ['/lib/appium_lib/ios/**/*.rb']
+
+run 'docs/android_docs.md', globs(android_globs)
+
+run 'docs/ios_docs.md', globs(ios_globs)
+=end
+    end
+  end
+end

data/lib/appium_thor/helpers.rb

@@ -0,0 +1,179 @@
+module Appium
+  module Thor
+    module Helpers
+      def _build_gem
+        `chmod 0600 ~/.gem/credentials`
+        sh "gem build #{gem_name}.gemspec"
+      end
+
+      def tag_exists tag_name
+        cmd = %Q(git branch -a --contains "#{tag_name}")
+        POSIX::Spawn::Child.new(cmd).out.include? '* master'
+      end
+
+      def sh command
+        process = POSIX::Spawn::Child.new command
+
+        unless process.success?
+          raise "Command #{command} failed. out: #{process.out}\nerr: #{process.err}"
+        end
+
+        out = process.out
+        out ? out.strip : out
+      end
+
+      def version_rgx
+        /\s*VERSION\s*=\s*'([^']+)'/m
+      end
+
+      def version
+        @version ||= File.read(version_file).match(version_rgx)[1]
+      end
+
+      def _bump value
+        data = File.read version_file
+
+        v_line = data.match version_rgx
+        d_line = data.match /\s*DATE\s*=\s*'([^']+)'/m
+
+        old_v = v_line[0]
+        old_d = d_line[0]
+
+        old_num     = v_line[1]
+        new_num     = old_num.split('.')
+        new_num[-1] = new_num[-1].to_i + 1
+
+        if value == :y
+          new_num[-1] = 0 # x.y.Z -> x.y.0
+          new_num[-2] = new_num[-2].to_i + 1 # x.Y -> x.Y+1
+        elsif value == :x
+          new_num[-1] = 0 # x.y.Z -> x.y.0
+          new_num[-2] = 0 # x.Y.z -> x.0.z
+          new_num[-3] = new_num[-3].to_i + 1
+        end
+
+        new_num = new_num.join '.'
+
+        new_v = old_v.sub old_num, new_num
+        puts "#{old_num} -> #{new_num}"
+
+        old_date = d_line[1]
+        new_date = Date.today.to_s
+        new_d    = old_d.sub old_date, new_date
+        puts "#{old_date} -> #{new_date}" unless old_date == new_date
+
+        data.sub! old_v, new_v
+        data.sub! old_d, new_d
+
+        File.write version_file, data
+      end
+
+      def update_release_notes
+        tag_sort = ->(tag1, tag2) do
+          tag1_numbers = tag1.match(/\.?v(\d+\.\d+\.\d+)$/)[1].split('.').map! { |n| n.to_i }
+          tag2_numbers = tag2.match(/\.?v(\d+\.\d+\.\d+)$/)[1].split('.').map! { |n| n.to_i }
+          tag1_numbers <=> tag2_numbers
+        end
+
+        tags = `git tag`.split "\n"
+        tags.sort! &tag_sort
+        pairs = []
+        tags.each_index { |a| pairs.push tags[a] + '...' + tags[a+1] unless tags[a+1].nil? }
+
+        notes = ''
+
+        dates = `git log --tags --simplify-by-decoration --pretty="format:%d %ad" --date=short`.split "\n"
+
+        pairs.sort! &tag_sort
+        pairs.reverse! # pairs are in reverse order.
+
+        tag_date = []
+        pairs.each do |pair|
+          tag = pair.split('...').last
+          dates.each do |line|
+            # regular tag, or tag on master.
+            if line.include?(tag + ')') || line.include?(tag + ',')
+              tag_date.push tag + ' ' + line.match(/\d{4}-\d{2}-\d{2}/)[0]
+              break
+            end
+          end
+        end
+
+        pairs.each_index do |a|
+          data     =`git log --pretty=oneline #{pairs[a]}`
+          new_data = ''
+          data.split("\n").each do |line|
+            hex     = line.match(/[a-zA-Z0-9]+/)[0]
+            # use first 7 chars to match GitHub
+            comment = line.gsub(hex, '').strip
+            next if comment == 'Update release notes'
+            new_data += "- [#{hex[0...7]}](https://github.com/appium/#{github_name}/commit/#{hex}) #{comment}\n"
+          end
+          data  = new_data + "\n"
+
+          # last pair is the released version.
+          notes += "#### #{tag_date[a]}\n\n" + data + "\n"
+        end
+
+        File.open('release_notes.md', 'w') { |f| f.write notes.to_s.strip }
+      end
+
+      def _install
+        _build_gem
+        _uninstall
+        sh "gem install --no-rdoc --no-ri --local #{gem_name}-#{version}.gem"
+      end
+
+      def _uninstall
+        cmd = "gem uninstall -aIx #{gem_name}"
+        # rescue on gem not installed error.
+        begin
+          sh "#{cmd}"
+        rescue
+        end
+      end
+
+      def _publish
+        unless `git branch`.include? '* master'
+          puts 'Master branch required to release.'
+          exit!
+        end
+
+        # ensure gems are installed
+        `bundle update`
+
+        # Commit then pull before pushing.
+        tag_name = "v#{version}"
+        raise 'Tag already exists!' if tag_exists tag_name
+
+        # Commit then pull before pushing.
+        sh "git commit --allow-empty -am 'Release #{version}'"
+        sh 'git pull'
+        sh "git tag #{tag_name}"
+        # update notes now that there's a new tag
+        notes
+        docs
+        sh "git commit --allow-empty -am 'Update release notes'"
+        sh 'git push origin master'
+        sh "git push origin #{tag_name}"
+        _build_gem
+        sh "gem push #{gem_name}-#{version}.gem"
+      end
+
+      # Remove non-ascii bytes from all rb files in the current working directory.
+      # Used to purge byte order marks that mess up YARD
+      def remove_non_ascii_from_cwd
+        glob = File.expand_path File.join(Dir.pwd, '**', '*.rb')
+        Dir.glob(glob) do |path|
+          path = File.expand_path path
+          next if File.directory? path
+
+          data = File.read path
+          data = data.encode('US-ASCII', invalid: :replace, undef: :replace, replace: '')
+          data = data.encode('UTF-8')
+          File.open(path, 'w') { |f| f.write data }
+        end
+      end
+    end # module Helpers
+  end # module Thor
+end # module Appium

data/lib/appium_thor/version.rb

@@ -0,0 +1,6 @@
+module Appium
+  module Thor
+    VERSION = '0.0.4' unless defined? ::Appium::Thor::VERSION
+    DATE    = '2014-07-31' unless defined? ::Appium::Thor::DATE
+  end
+end

data/lib/appium_thor.rb

@@ -0,0 +1,17 @@
+# stdlib
+
+require 'forwardable' # commands.rb
+require 'singleton'   # config.rb
+
+# gems
+require 'rubygems'
+require 'yard'
+require 'posix-spawn'
+require 'date'
+
+require_relative 'appium_thor/docs'
+require_relative 'appium_thor/helpers'
+require_relative 'appium_thor/version'
+
+require_relative 'appium_thor/config'
+require_relative 'appium_thor/commands/commands'

data/release_notes.md

@@ -0,0 +1,10 @@
+#### v0.0.4 2014-07-31
+
+- [b0f4217](https://github.com/appium/appium_thor/commit/b0f42170c7b7df3befa9651647ea8c65ecd86710) Release 0.0.4
+- [68f6e7b](https://github.com/appium/appium_thor/commit/68f6e7b4d641017eee1123fbcc9872940adf37b8) Fix update_release_notes
+
+
+#### v0.0.3 2014-07-31
+
+- [71b4199](https://github.com/appium/appium_thor/commit/71b419998ce835cf1e722563cd9ba99d89da6fb0) Release 0.0.3
+- [9904612](https://github.com/appium/appium_thor/commit/99046121f53f42bebb0cea4971f89b91c358da22) Testing release notes

metadata

@@ -0,0 +1,113 @@
+--- !ruby/object:Gem::Specification
+name: appium_thor
+version: !ruby/object:Gem::Version
+  version: 0.0.4
+platform: ruby
+authors:
+- code@bootstraponline.com
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-07-31 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: redcarpet
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.1.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.1.2
+- !ruby/object:Gem::Dependency
+  name: posix-spawn
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.3.8
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.3.8
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.8.7.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.8.7.4
+description: Thor tasks for Appium gems.
+email:
+- code@bootstraponline.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE
+- README.md
+- Thorfile
+- appium_thor.gemspec
+- lib/appium_thor.rb
+- lib/appium_thor/commands/commands.rb
+- lib/appium_thor/commands/init.rb
+- lib/appium_thor/config.rb
+- lib/appium_thor/docs.rb
+- lib/appium_thor/helpers.rb
+- lib/appium_thor/version.rb
+- release_notes.md
+homepage: https://github.com/appium/appium_thor
+licenses:
+- http://www.apache.org/licenses/LICENSE-2.0.txt
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 1.9.3
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Thor tasks for Appium gems
+test_files: []
+has_rdoc: