appium_thor 1.2.0 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bc24b49b7f663d776fb593f9767227d3269719b66ff51401d0940c005794a03c
-  data.tar.gz: 207e3e8d662f3bc569d6a36e407231ab9455e4228cc7698f9a4d7dd963e0f640
+  metadata.gz: cf2076f3692848707a188c8fd4894f6db4be3e9a3846c7ec968956bcff35996d
+  data.tar.gz: 9f7ae671336d09075b901b9d156d2472950ef6bf7bd576895aeb4e85600b83eb
 SHA512:
-  metadata.gz: 118622a121311f5fe6e16c21ff9918e6eece9d43c2940a106e6d67b34220bdcffdcc2ba755bbe210fd9489564922695d53c63c7b7c37808f062dba4f162e281e
-  data.tar.gz: 880766372aab982e0de70bd875884b6bed2c231ece910d458cf36deca4ec1f8cb8b29d8a71310da942c634619b1003e5226af3817c94906be2e92264a7a278d5
+  metadata.gz: cecba2f6985427e8c22512f1111a01d84f981e1ddb290d07af18e3a3aa91b5b9024e93742fa9ee9a61672b84a4022f9b587f5251c5251153630036f7d68fbec4
+  data.tar.gz: 63fe0809f01b8d8dc6ea4db7dd340a4644299199b7e673df187cccd748f88b1cb769637a32f75c3738bd6a9bdd9dacf96f161f373fd567d9d3fdb40a98306327

data/README.md

@@ -16,9 +16,6 @@ Appium::Thor::Config.set do
   github_name  'appium_thor'
        branch  'master'
   version_file 'lib/appium_thor/version.rb'
-  docs_block do
-    run 'docs/helpers_docs.md', globs('/lib/appium_thor/helpers.rb')
-  end
 end
 
 # Must use '::' otherwise Default will point to Thor::Sandbox::Default
@@ -43,7 +40,6 @@ end
 |github_name  | `#{gem_name}`|
 |branch       | `master`|
 |version_file | `lib/#{gem_name}/version.rb`|
-|docs_block   | no docs are generated|
 
 `branch` customises the target branch to push changes.
 Defaults to `master`
@@ -60,7 +56,6 @@ 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 date.
 thor bumpy          # Bump the y version number, set z to zero, update the date.
 thor byte           # Remove non-ascii bytes from all *.rb files in the current dir
-thor docs           # Update docs
 thor gem_install    # Install gem
 thor gem_uninstall  # Uninstall gem
 thor info           # prints config info for this gem
@@ -68,19 +63,3 @@ thor notes          # Update release notes
 thor publish        # Build and release a new gem to rubygems.org
 thor release        # Build and release a new gem to rubygems.org (same as publish)
 ```
-
---
-
-# docs_block
-
-The `docs_block` method runs within the `docs.rb` context. Here's a more complex example:
-
-```ruby
-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)
-```

data/Thorfile

@@ -3,7 +3,4 @@ require File.expand_path '../lib/appium_thor', __FILE__
 Appium::Thor::Config.set do
   appium_thor = 'appium_thor'
   gem_name     appium_thor
-  docs_block do
-    run 'docs/helpers_docs.md', globs("/lib/#{appium_thor}/helpers.rb")
-  end
-end
+end

data/appium_thor.gemspec

@@ -1,7 +1,7 @@
 require_relative 'lib/appium_thor/version'
 
 Gem::Specification.new do |s|
-  s.required_ruby_version = '>= 2.2'
+  s.required_ruby_version = '>= 3.0'
 
   s.name          = 'appium_thor'
   s.version       = Appium::Thor::VERSION
@@ -13,8 +13,6 @@ Gem::Specification.new do |s|
   s.require_paths = ['lib']
 
   s.add_runtime_dependency 'redcarpet', '~> 3.1', '>= 3.1.2'
-  s.add_runtime_dependency 'posix-spawn', '~> 0.3', '>= 0.3.8'
-  s.add_runtime_dependency 'yard', '~> 0.9.11'
 
   s.files = `git ls-files`.split "\n"
 end

data/lib/appium_thor/commands/commands.rb

@@ -55,11 +55,6 @@ version_file: #{version_file}
     _install
   end
 
-  desc 'docs', 'Update docs'
-  def docs
-    instance_eval &docs_block if docs_block
-  end
-
   desc 'notes', 'Update release notes'
   def notes
     update_release_notes
@@ -69,4 +64,8 @@ version_file: #{version_file}
   def byte
     remove_non_ascii_from_cwd
   end
-end
+
+  def self.exit_on_failure?
+    true
+  end
+end

data/lib/appium_thor/commands/init.rb

@@ -2,7 +2,6 @@
 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

data/lib/appium_thor/config.rb

@@ -21,16 +21,9 @@ module Appium
         raise "version file doesn't exist #{@version_file}" unless File.exist?(@version_file)
       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
-
       # Returns all options as symbols. Required for defining delegators in init.rb
       def self.options
-        string_options + [:docs_block]
+        string_options
       end
 
       # the subset of options that operate on strings

data/lib/appium_thor/helpers.rb

@@ -11,19 +11,20 @@ module Appium
       # Returns true if the tag exists on the master branch.
       def tag_exists(tag_name)
         cmd = %Q(git branch -a --contains "#{tag_name}")
-        POSIX::Spawn::Child.new(cmd).out.include? "* #{branch}"
+        stdout, status = Open3.capture2(cmd)
+        stdout.include? "* #{branch}"
+
       end
 
       # Runs command. Raises an exception if the command doesn't execute successfully.
       def sh(command)
-        process = POSIX::Spawn::Child.new command
+        stdout, stderr, status = Open3.capture3(command)
 
-        unless process.success?
-          raise "Command #{command} failed. out: #{process.out}\nerr: #{process.err}"
+        unless status.success?
+          raise "Command #{command} failed. out: #{stdout}\nerr: #{stderr}"
         end
 
-        out = process.out
-        out ? out.strip : out
+        stdout.strip
       end
 
       # Used to parse the version number from version_file
@@ -187,7 +188,6 @@ module Appium
 
         # update notes now that there's a new tag
         notes rescue notes_failed = true
-        docs
         sh "git commit --allow-empty -am 'Update release notes'" unless notes_failed
         sh "git push origin #{branch}"
         sh "git push origin #{tag_name}"

data/lib/appium_thor/version.rb

@@ -1,6 +1,6 @@
 module Appium
   module Thor
-    VERSION = '1.2.0' unless defined? ::Appium::Thor::VERSION
-    DATE    = '2020-06-14' unless defined? ::Appium::Thor::DATE
+    VERSION = '2.0.0' unless defined? ::Appium::Thor::VERSION
+    DATE    = '2024-04-26' unless defined? ::Appium::Thor::DATE
   end
 end

data/lib/appium_thor.rb

@@ -2,15 +2,13 @@
 require 'forwardable' # commands.rb
 require 'singleton'   # config.rb
 require 'fileutils'
+require 'open3'
 
 # gems
 require 'rubygems'
-require 'yard'        # docs.rb
-require 'posix-spawn' # helpers.rb
 require 'date'        # helpers.rb Date.today
 
 # internal
-require_relative 'appium_thor/docs'
 require_relative 'appium_thor/helpers'
 require_relative 'appium_thor/version'
 require_relative 'appium_thor/config'

data/release_notes.md

@@ -1,3 +1,11 @@
+#### v2.0.0 2024-04-26
+
+- [e83d36e](https://github.com/appium/appium_thor/commit/e83d36e65c48dcfc71b00d28837a4c57517cc6b2) Release 2.0.0
+- [021199b](https://github.com/appium/appium_thor/commit/021199b3bb179432cac93709292a275470f4bca7) chore: remove posix-spawn
+- [11848db](https://github.com/appium/appium_thor/commit/11848db549003ba9b267622eb3e2677c4b9a004d) chore: use ruby 3+
+- [3b3cf1d](https://github.com/appium/appium_thor/commit/3b3cf1d278ec18923875c5469e4e1da31df92472) feat: remove docs (#8)
+
+
 #### v1.2.0 2020-06-14
 
 - [5c7025a](https://github.com/appium/appium_thor/commit/5c7025a14e9a6dba1ff0f69b733983d965e9c2ee) Release 1.2.0

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: appium_thor
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 2.0.0
 platform: ruby
 authors:
 - code@bootstraponline.com
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-06-14 00:00:00.000000000 Z
+date: 2024-04-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: redcarpet
@@ -30,40 +30,6 @@ dependencies:
     - - ">="
       - !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.9.11
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 0.9.11
 description: Thor tasks for Appium gems.
 email:
 - code@bootstraponline.com
@@ -82,7 +48,6 @@ files:
 - 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
@@ -90,7 +55,7 @@ homepage: https://github.com/appium/appium_thor
 licenses:
 - http://www.apache.org/licenses/LICENSE-2.0.txt
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -98,15 +63,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.2'
+      version: '3.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
-signing_key: 
+rubygems_version: 3.5.9
+signing_key:
 specification_version: 4
 summary: Thor tasks for Appium gems.
 test_files: []

data/lib/appium_thor/docs.rb

@@ -1,82 +0,0 @@
-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/) || 'common'
-        out.concat("##### [#{obj.name.to_s}](https://github.com/#{github_owner}/#{github_name}/blob/#{last_sha}/lib/#{method_path}#L#{obj.line}) #{os}\n\n")
-        out.concat("> #{obj.signature}\n\n")
-        out.concat("#{obj.docstring}\n\n")
-
-
-        indent = space 5
-        params = obj.tags.select { |tag| tag.tag_name == 'param' }
-        unless params.empty?
-          out.concat("__Parameters:__\n\n")
-          params.each do |param|
-            out.concat("#{indent}[#{param.types.join(', ') unless param.types.nil?}] ")
-            out.concat("#{param.name} - #{param.text}\n\n")
-          end
-        end
-
-        ret = obj.tag 'return'
-        if ret
-          out.concat("__Returns:__\n\n")
-          out.concat("#{indent}[#{ret.types.join(', ') unless ret.types.nil?}] #{ret.text}\n\n")
-        end
-        out.concat("--\n\n")
-
-        out
-      end
-
-      def run(out_file, globs)
-        YARD::Registry.clear
-        puts "Globbing: #{globs}"
-        puts "Writing: #{out_file}"
-        FileUtils.mkdir_p File.dirname 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
-    end
-  end
-end