qiita_org 0.1.0

data/gems/ruby/2.7.0/gems/command_line-2.0.1/.editorconfig

@@ -0,0 +1,11 @@
+root = true
+
+# Everywhere
+[*]
+end_of_line = lf # Unix-style newlines
+trim_trailing_whitespace = true
+
+# Ruby
+[.rb, .rake, Rakefile]
+indent_style = space
+indent_size = 2

data/gems/ruby/2.7.0/gems/command_line-2.0.1/.github/workflows/linux.yml

@@ -0,0 +1,22 @@
+name: Linux
+
+on: [push, pull_request]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        ruby: [2.7, 2.6, 2.5]
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Ruby ${{ matrix.ruby }}
+      uses: actions/setup-ruby@v1
+      with:
+        ruby-version: ${{ matrix.ruby }}
+    - name: Build
+      run: |
+        gem install bundler
+        bundle install --jobs 4 --retry 3
+    - name: Test
+      run: bundle exec rake

data/gems/ruby/2.7.0/gems/command_line-2.0.1/.github/workflows/macos.yml

@@ -0,0 +1,22 @@
+name: MacOS
+
+on: [push, pull_request]
+
+jobs:
+  build:
+    runs-on: macos-latest
+    strategy:
+      matrix:
+        ruby: [2.7, 2.6, 2.5]
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Ruby ${{ matrix.ruby }}
+      uses: actions/setup-ruby@v1
+      with:
+        ruby-version: ${{ matrix.ruby }}
+    - name: Build
+      run: |
+        gem install bundler
+        bundle install --jobs 4 --retry 3
+    - name: Test
+      run: bundle exec rake

data/gems/ruby/2.7.0/gems/command_line-2.0.1/.github/workflows/windows.yml

@@ -0,0 +1,22 @@
+name: Windows
+
+on: [push, pull_request]
+
+jobs:
+  build:
+    runs-on: windows-latest
+    strategy:
+      matrix:
+        ruby: [2.7, 2.6, 2.5]
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Ruby ${{ matrix.ruby }}
+      uses: actions/setup-ruby@v1
+      with:
+        ruby-version: ${{ matrix.ruby }}
+    - name: Build
+      run: |
+        gem install bundler
+        bundle install --jobs 4 --retry 3
+    - name: Test
+      run: bundle exec rake

data/gems/ruby/2.7.0/gems/command_line-2.0.1/.gitignore

@@ -0,0 +1,7 @@
+/.bundle/
+/.yardoc
+/pkg/
+/spec/reports/
+/spec/examples.txt
+/doc
+Gemfile.lock

data/gems/ruby/2.7.0/gems/command_line-2.0.1/.rspec

@@ -0,0 +1,2 @@
+--require spec_helper
+--color

data/gems/ruby/2.7.0/gems/command_line-2.0.1/.rubocop.yml

@@ -0,0 +1,21 @@
+AllCops:
+  TargetRubyVersion: 2.5
+  Exclude:
+  - '*.gemspec'
+  - Gemfile
+  - Rakefile
+  - spec/fixtures/**/*
+  - bin/**/*
+Layout/ArgumentAlignment:
+  EnforcedStyle: with_fixed_indentation
+Layout/FirstHashElementIndentation:
+  EnforcedStyle: consistent
+Metrics/BlockLength:
+  Exclude:
+    - spec/**/*
+Metrics/AbcSize:
+  Enabled: false
+Metrics/MethodLength:
+  Enabled: false
+Style/RescueModifier:
+  Enabled: false

data/gems/ruby/2.7.0/gems/command_line-2.0.1/.yardopts

@@ -0,0 +1,6 @@
+--markup markdown
+--markup-provider redcarpet
+--readme README.md
+-
+CHANGELOG.md
+LICENSE.txt

data/gems/ruby/2.7.0/gems/command_line-2.0.1/CHANGELOG.md

@@ -0,0 +1,43 @@
+# [2.0.1] (2020-04-17)
+
+## Fixed
+
+- Deprecation warning about keyword arguments.
+
+# [2.0.0] (2020-04-13)
+
+## Changed
+
+- Arguments are now always sent as a single command to `Open3.popen3`. Sending as multiple arguments can cause it to not use the shell. Passing as a single argument ensures the shell is always used.
+- Drop support for Ruby 2.4.
+
+## Added
+
+- The `:env` flag now accepts non-string keys and will convert them to strings.
+
+## Fixed
+
+- Deprecation warning about keyword arguments.
+
+# [1.1.0] (2019-10-23)
+
+## Added
+
+- CommandLine.command_line!
+- Added a `:timeout` argument for setting a timeout.
+- Allow more than strings as arguments to pass to the command. We'll convert everything with `to_s`.
+
+# [1.0.1] (2019-08-16)
+
+## Fixed
+
+- Massive output on stdout or stderr could block forever.
+
+# 1.0.0 (2019-08-15)
+
+Initial release.
+
+[2.0.1]: https://github.com/DragonRuby/command_line/compare/v2.0.0...v2.0.1
+[2.0.0]: https://github.com/DragonRuby/command_line/compare/v1.1.0...v2.0.0
+[1.1.0]: https://github.com/DragonRuby/command_line/compare/v1.0.1...v1.1.0
+[1.0.1]: https://github.com/DragonRuby/command_line/compare/v1.0.0...v1.0.1

data/gems/ruby/2.7.0/gems/command_line-2.0.1/CONTRIBUTING.md

@@ -0,0 +1,24 @@
+# Steps
+
+1. [Fork][] the repo.
+2. Add a breaking test for your change.
+3. Make the tests pass.
+4. Push your fork.
+5. Submit a pull request.
+
+## Code Style
+
+This project uses [EditorConfig] to tell editors what formatting to use.
+It's built into many editors and there are plugins for nearly every other editor that will automatically enforce the formatting.
+If you want to handle it manually you can look at the [.editorconfig] file to see the rules to follow.
+
+# Testing
+
+Running the tests using `rake` (with no args) will also check for style issues in the code.
+Ideally all submissions would pass these checks.
+If the code style is causing issues we can work with you to correct it.
+Don't let it stop you from contributing.
+
+[fork]: https://github.com/DragonRuby/command_line
+[EditorConfig]: https://editorconfig.org/
+[.editorconfig]: .editorconfig

data/gems/ruby/2.7.0/gems/command_line-2.0.1/Gemfile

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

data/gems/ruby/2.7.0/gems/command_line-2.0.1/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2019 Aaron Lasseigne
+
+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/gems/ruby/2.7.0/gems/command_line-2.0.1/README.md

@@ -0,0 +1,109 @@
+# CommandLine
+
+[![Version](https://img.shields.io/gem/v/command_line.svg?style=flat-square)](https://rubygems.org/gems/command_line)
+[![Linux Build](https://img.shields.io/github/workflow/status/DragonRuby/command_line/Linux?label=Linux&style=flat-square)](https://github.com/DragonRuby/command_line/actions?query=workflow%3ALinux)
+[![MacOS Build](https://img.shields.io/github/workflow/status/DragonRuby/command_line/MacOS?label=MacOS&style=flat-square)](https://github.com/DragonRuby/command_line/actions?query=workflow%3AMacOS)
+[![Windows Build](https://img.shields.io/github/workflow/status/DragonRuby/command_line/Windows?label=Windows&style=flat-square)](https://github.com/DragonRuby/command_line/actions?query=workflow%3AWindows)
+
+CommandLine provides an easier way to run command-line applications.
+It captures all outputs, can handle applications that require stdin, and can pass environment variables.
+It's also helpful for testing commmand-line applications.
+
+This project is tested against and works on Linux, OS X, and Windows.
+
+## Installation
+
+This project uses [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'command_line', '~> 2.0'
+```
+
+If you want `command_line` available globally you can add this line to your application's Gemfile:
+
+```ruby
+gem 'command_line', '~> 2.0', require: 'command_line/global'
+```
+
+Or manually install it yourself with:
+
+```sh
+$ gem install command_line
+```
+
+In a script you can make `command_line` available globally with:
+
+```ruby
+require 'command_line/global'
+```
+
+## Usage
+
+All examples below assume that `command_line` has been made available globally.
+If not, simply call `CommandLine.command_line` instead of `command_line`.
+
+With `command_line` you to easily run commands and check their `stdout`, `stderr`, and exit status.
+
+```ruby
+>> result = command_line('echo', 'hello')
+=> #<CommandLine::Result ...>
+>> result.stdout
+=> "hello\n"
+>> result.stderr
+=> ""
+>> result.exited?
+=> true
+>> result.exitstatus
+=> 0
+>> result.success?
+=> true
+>> result.failure?
+=> false
+```
+
+If your application requires input use a block to send input.
+
+```ruby
+command_line('command_expecting_input') do |stdin|
+  stdin.puts "first input"
+  stdin.puts "second input"
+end
+```
+
+Environment variables can be passed after the command and arguments are passed.
+
+```ruby
+command_line('some_webserver', env: { PORT: '80' })
+```
+
+If you're concerned about the command running too long you can set a `:timeout`.
+Exceeding the timeout will cause a `CommandLine::TimeoutError` to be raised.
+
+```ruby
+>> command_line('sleep', 5, timeout: 2)
+CommandLine::TimeoutError (execution expired)
+```
+
+You can use `command_line!` if you want to raise an error on an exit failure.
+The contents of `stderr` will be the error message.
+
+```ruby
+>> command_line!('grep')
+CommandLine::ExitFailureError (usage: grep [-abc....
+```
+
+### RSpec
+
+To have direct access to `CommandLine.command_line` you can include it in `spec/spec_helper.rb`.
+
+```ruby
+require 'command_line'
+
+RSpec.configure do |config|
+  config.include CommandLine
+end
+```
+
+This will make `command_line` available in your test suite.

data/gems/ruby/2.7.0/gems/command_line-2.0.1/Rakefile

@@ -0,0 +1,10 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+require 'rubocop/rake_task'
+
+RSpec::Core::RakeTask.new
+RuboCop::RakeTask.new do |task|
+  task.options = ['--display-cop-names']
+end
+
+task default: %i[spec rubocop]

data/gems/ruby/2.7.0/gems/command_line-2.0.1/bin/console

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+
+require 'bundler/setup'
+require 'command_line'
+
+require 'irb'
+IRB.start(__FILE__)

data/gems/ruby/2.7.0/gems/command_line-2.0.1/bin/setup

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install

data/gems/ruby/2.7.0/gems/command_line-2.0.1/command_line.gemspec

@@ -0,0 +1,35 @@
+require_relative 'lib/command_line/version'
+
+Gem::Specification.new do |spec|
+  spec.name    = 'command_line'
+  spec.version = CommandLine::VERSION
+  spec.authors = ['Aaron Lasseigne']
+  spec.email   = ['aaron.lasseigne@dragonruby.org']
+
+  spec.summary     = 'An easier way execute command line applications and get all of the output.'
+  spec.description = spec.summary
+  spec.homepage    = 'https://github.com/DragonRuby/command_line'
+  spec.license     = 'MIT'
+
+  if spec.respond_to?(:metadata)
+    spec.metadata['homepage_uri'] = spec.homepage
+    spec.metadata['source_code_uri'] = 'https://github.com/DragonRuby/command_line'
+    spec.metadata['changelog_uri'] = 'https://github.com/DragonRuby/command_line/blob/master/CHANGELOG.md'
+  end
+
+  spec.required_ruby_version = '>= 2.4'
+
+  spec.files = Dir.chdir(File.expand_path('..', __FILE__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'bundler', '~> 2.0'
+  spec.add_development_dependency 'rake', '~> 13.0'
+  spec.add_development_dependency 'rspec', '~> 3.9'
+  spec.add_development_dependency 'rubocop', '~> 0.81.0'
+  spec.add_development_dependency 'yard', '~> 0.9.20'
+  spec.add_development_dependency 'redcarpet', '~> 3.5.0'
+end

data/gems/ruby/2.7.0/gems/command_line-2.0.1/lib/command_line.rb

@@ -0,0 +1,100 @@
+# frozen_string_literal: true
+
+require 'open3'
+require 'timeout'
+
+require 'command_line/result'
+require 'command_line/version'
+
+# CommandLine provides an easier way to run command-line applications.  It
+# captures all outputs, can handle applications that require stdin, and can pass
+# environment variables. It's also helpful for testing commmand-line
+# applications.
+module CommandLine
+  # Top-level error class. All other errors subclass this.
+  class Error < StandardError; end
+
+  # Raised if CommandLine#command_line! is called an has an exit failure.
+  class ExitFailureError < Error; end
+
+  # Raised if a timeout is given and exceeded.
+  class TimeoutError < Error; end
+
+  module_function
+
+  # Run a command and get back the result.
+  #
+  # @param command [String] The command to run.
+  # @param args [Array] Any arguments passed to the command. All arguments will
+  #   be converted to strings using `to_s`.
+  # @param [Hash] env: Pass environment variables to use. The key is the name
+  #   of the environment variable. The value is the value you want that variable
+  #   to have.
+  # @param [Integer, Float, nil] Number of seconds to wait for the block to
+  #   terminate. Floats can be used to specify fractional seconds. A value of 0
+  #   or nil will execute the block without any timeout.
+  #
+  # @yield [stdin] Handle any input on stdin that the command needs.
+  # @yieldparam stdin [IO]
+  #
+  # @example
+  #   command_line('echo', 'hello')
+  #
+  # @example
+  #   command_line('command_expecting_input') do |stdin|
+  #     stdin.puts "first input"
+  #     stdin.puts "second input"
+  #   end
+  #
+  # @example
+  #   command_line('some_webserver', env: { PORT: '80' })
+  #
+  # @return [Result]
+  def command_line(command, *args, env: {}, timeout: nil)
+    stdout = ''
+    stderr = ''
+    status = nil
+
+    full_command = [command, *args].map(&:to_s).join(' ')
+    environment = env.transform_keys(&:to_s)
+    Open3.popen3(environment, full_command) do |i, o, e, wait_thr|
+      threads = []
+
+      Timeout.timeout(timeout, TimeoutError) do
+        yield i if block_given?
+
+        threads << Thread.new { stdout = o.read }
+        threads << Thread.new { stderr = e.read }
+        threads.each(&:join)
+        status = wait_thr.value
+      end
+    rescue TimeoutError => e
+      threads.map(&:kill)
+
+      raise e
+    end
+
+    Result.new(stdout, stderr, status)
+  end
+
+  # Same as {CommandLine.command_line} except that a failure on exit raises an
+  # error.
+  #
+  # @see CommandLine.command_line
+  #
+  # @example
+  #   command_line!('echo', 'hello')
+  #
+  # @example
+  #   command_line!('grep')
+  #   # => CommandLine::ExitFailureError (usage: grep ...
+  #
+  # @return [Result]
+  # @raise [CommandLine::ExitFailureError] If the application exits with an
+  #   error status. The message will be the contents of Result#stderr.
+  def command_line!(*args, **kwargs, &block)
+    command_line(*args, **kwargs, &block).tap do |result|
+      raise ExitFailureError, result.stderr if result.failure?
+    end
+  end
+end