tty-command 0.8.0 → 0.10.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 0da26e779e4608d8ea38cf75801e0afa682dfd14
-  data.tar.gz: 1a8f798ca2de05727cd9217a20314a9730763cd9
+SHA256:
+  metadata.gz: f62b4f72ffaff00cb6e0f7d7f53159e48716746a157e367807771f4fceeef249
+  data.tar.gz: 761e3df2ac357a5591bc4d873b87f419926f73a5e06b42553e9c0d9d1924ab16
 SHA512:
-  metadata.gz: 6c966cec07e3ded53c89a294291e4ae9b74cdc7c0c81fb9a5843cd26bb0d7846fe14d57ae4b44756f8b5567fe40163bc27d7e33f2fedecb9826e97892002b9ba
-  data.tar.gz: d098129b2cda2da46cab16cc33f1086f7f1aa163b6c6d6a4e4d2a62103ba9e626704bfc2f275e7e6583cbeab3ee5a9352de48135d214b491caaeae8f550e000d
+  metadata.gz: 8f32eb43589d385247d787d3d4d263760e764111cc125a4651f5372b456d6a0464572d30aff6a3b3c9872dbf913c2281b7d094cab0d4c3bb7f31d03c131e1cfa
+  data.tar.gz: 668d73499b869f65cb8bf3e6eafcf2b8a7d130fbf1821a8681be70464399c31cc192fff20055ae928395c14e59bd21ecf459b1dc2afe647fb4112fd69855cdbb

data/CHANGELOG.md

@@ -1,5 +1,40 @@
 # Change log
 
+## [v0.10.1] - 2021-02-14
+
+### Fixed
+* Fix undesired persistence of environment variables in Ruby >= 3.0.0
+
+## [v0.10.0] - 2020-10-22
+
+### Changed
+* Change :chdir option to escape directory location path
+* Change gemspec to add metadata and remove test artefacts
+* Change to update pastel dependency and restrict version to minor only
+* Remove bundler as a dev dependency and relax rspec's upper boundary
+
+### Fixed
+* Fix Ruby 2.7 keyword conversion errors
+* Fix error when environment variable contains % character
+
+## [v0.9.0] - 2019-09-28
+
+### Changed
+* Change gemspec to require Ruby >= 2.0.0
+
+## [v0.8.2] - 2018-08-07
+
+### Changed
+* Change gemspec to load only required files
+
+### Fixed
+* Fix issue with Ruby greater than 2.5.0 displaying thread error traceback by default
+
+## [v0.8.1] - 2018-05-20
+
+### Changed
+* Change ProcessRunner#write_stream to handle all writing logic
+
 ## [v0.8.0] - 2018-04-22
 
 ### Added
@@ -110,6 +145,11 @@
 
 * Initial implementation and release
 
+[v0.10.1]: https://github.com/piotrmurach/tty-command/compare/v0.10.0...v0.10.1
+[v0.10.0]: https://github.com/piotrmurach/tty-command/compare/v0.9.0...v0.10.0
+[v0.9.0]: https://github.com/piotrmurach/tty-command/compare/v0.8.2...v0.9.0
+[v0.8.2]: https://github.com/piotrmurach/tty-command/compare/v0.8.1...v0.8.2
+[v0.8.1]: https://github.com/piotrmurach/tty-command/compare/v0.8.0...v0.8.1
 [v0.8.0]: https://github.com/piotrmurach/tty-command/compare/v0.7.0...v0.8.0
 [v0.7.0]: https://github.com/piotrmurach/tty-command/compare/v0.6.0...v0.7.0
 [v0.6.0]: https://github.com/piotrmurach/tty-command/compare/v0.5.0...v0.6.0
@@ -120,4 +160,4 @@
 [v0.3.1]: https://github.com/piotrmurach/tty-command/compare/v0.3.0...v0.3.1
 [v0.3.0]: https://github.com/piotrmurach/tty-command/compare/v0.2.0...v0.3.0
 [v0.2.0]: https://github.com/piotrmurach/tty-command/compare/v0.1.0...v0.2.0
-[v0.1.0]: https://github.com/piotrmurach/tty-command/compare/v0.1.0
+[v0.1.0]: https://github.com/piotrmurach/tty-command/compare/953ccdd...v0.1.0

data/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2016 Piotr Murach
+Copyright (c) 2016 Piotr Murach (https://piotrmurach.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

data/README.md

@@ -1,7 +1,11 @@
+<div align="center">
+  <a href="https://ttytoolkit.org"><img width="130" src="https://github.com/piotrmurach/tty/blob/master/images/tty.png" alt="TTY Toolkit logo"/></a>
+</div>
+
 # TTY::Command [![Gitter](https://badges.gitter.im/Join%20Chat.svg)][gitter]
 
 [![Gem Version](https://badge.fury.io/rb/tty-command.svg)][gem]
-[![Build Status](https://secure.travis-ci.org/piotrmurach/tty-command.svg?branch=master)][travis]
+[![Actions CI](https://github.com/piotrmurach/tty-command/workflows/CI/badge.svg?branch=master)][gh_actions_ci]
 [![Build status](https://ci.appveyor.com/api/projects/status/0150ync7bdkfhmsv?svg=true)][appveyor]
 [![Code Climate](https://codeclimate.com/github/piotrmurach/tty-command/badges/gpa.svg)][codeclimate]
 [![Coverage Status](https://coveralls.io/repos/github/piotrmurach/tty-command/badge.svg)][coverage]
@@ -9,7 +13,7 @@
 
 [gitter]: https://gitter.im/piotrmurach/tty
 [gem]: http://badge.fury.io/rb/tty-command
-[travis]: http://travis-ci.org/piotrmurach/tty-command
+[gh_actions_ci]: https://github.com/piotrmurach/tty-command/actions?query=workflow%3ACI
 [appveyor]: https://ci.appveyor.com/project/piotrmurach/tty-command
 [codeclimate]: https://codeclimate.com/github/piotrmurach/tty-command
 [coverage]: https://coveralls.io/github/piotrmurach/tty-command
@@ -32,7 +36,7 @@ Why should we be handcuffed to `sh` or `bash` for these scripts when we could be
 Add this line to your application's Gemfile:
 
 ```ruby
-gem 'tty-command'
+gem "tty-command"
 ```
 
 And then execute:
@@ -84,11 +88,11 @@ Or install it yourself as:
 Create a command instance and then run some commands:
 
 ```ruby
-require 'tty-command'
+require "tty-command"
 
 cmd = TTY::Command.new
-cmd.run('ls -la')
-cmd.run('echo Hello!')
+cmd.run("ls -la")
+cmd.run("echo Hello!")
 ```
 
 Note that `run` will throw an exception if the command fails. This is already an improvement over ordinary shell scripts, which just keep on going when things go bad. That usually makes things worse.
@@ -96,7 +100,7 @@ Note that `run` will throw an exception if the command fails. This is already an
 You can use the return value to capture stdout and stderr:
 
 ```ruby
-out, err = cmd.run('cat ~/.bashrc | grep alias')
+out, err = cmd.run("cat ~/.bashrc | grep alias")
 ```
 
 Instead of using a plain old string, you can break up the arguments and they'll get escaped if necessary:
@@ -123,13 +127,13 @@ The `env`, `command` and `options` arguments are described in the following sect
 For example, to display file contents:
 
 ```ruby
-cmd.run('cat file.txt')
+cmd.run("cat file.txt")
 ```
 
 If the command succeeds, a `TTY::Command::Result` is returned that records stdout and stderr:
 
 ```ruby
-out, err = cmd.run('date')
+out, err = cmd.run("date")
 puts "The date is #{out}"
 # => "The date is Tue 10 May 2016 22:30:15 BST\n"
 ```
@@ -137,7 +141,7 @@ puts "The date is #{out}"
 You can also pass a block that gets invoked anytime stdout and/or stderr receive output:
 
 ```ruby
-cmd.run('long running script') do |out, err|
+cmd.run("long running script") do |out, err|
   output << out if out
   errors << err if err
 end
@@ -157,8 +161,8 @@ If the error output is very long, the stderr may contain only a prefix, number o
 If you expect a command to fail occasionally, use `run!` instead. Then you can detect failures and respond appropriately. For example:
 
 ```ruby
-if cmd.run!('which xyzzy').failure?
-  cmd.run('brew install xyzzy')
+if cmd.run!("which xyzzy").failure?
+  cmd.run("brew install xyzzy")
 end
 ```
 
@@ -180,7 +184,7 @@ cmd = TTY::Command.new(printer: :progress)
 By default the printers log to `stdout` but this can be changed by passing an object that responds to `<<` message:
 
 ```ruby
-logger = Logger.new('dev.log')
+logger = Logger.new("dev.log")
 cmd = TTY::Command.new(output: logger)
 ```
 
@@ -190,18 +194,34 @@ You can force the printer to always in print in color by passing the `:color` op
 cmd = TTY::Command.new(color: true)
 ```
 
+If the default printers don't meet your needs you can always create [a custom printer](#34-custom-printer)
+
 #### 2.3.1 Color
 
 When using printers you can switch off coloring by using `:color` option set to `false`.
 
-#### 2.3.2 Uuid
+#### 2.3.2 UUID
 
-By default, when logging is enabled, each log entry is prefixed by specific command run uuid number. This number can be switched off using the `:uuid` option:
+By default, when logging is enabled and `pretty` printer is used, each log entry is prefixed by specific command run uuid number. This number can be switched off using the `:uuid` option at initialization:
 
 ```ruby
 cmd = TTY::Command.new(uuid: false)
-cmd.run('rm -R all_my_files')
-# => rm -r all_my_files
+cmd.run("rm -R all_my_files")
+# =>
+#  Running rm -r all_my_files
+#  ...
+#  Finished in 6 seconds with exit status 0 (successful)
+```
+
+or individually per command run:
+
+```rub
+cmd = TTY::Command.new
+cmd.run("echo hello", uuid: false)
+# =>
+#  Running echo hello
+#      hello
+#  Finished in 0.003 seconds with exit status 0 (successful)
 ```
 
 #### 2.3.3 Only output on error
@@ -210,13 +230,13 @@ When using a command that can fail, setting `:only_output_on_error` option to `t
 
 ```ruby
 cmd = TTY::Command.new
-cmd.run('non_failing_command', only_output_on_error: true)
+cmd.run("non_failing_command", only_output_on_error: true)
 ```
 
 This will only print the `Running` and `Finished` lines, while:
 
 ```ruby
-cmd.run('non_failing_command')
+cmd.run("non_failing_command")
 ```
 
 will also print any output that the `non_failing_command` might generate.
@@ -224,13 +244,13 @@ will also print any output that the `non_failing_command` might generate.
 Running either:
 
 ```ruby
-cmd.run('failing_command', only_output_on_error: true)
+cmd.run("failing_command", only_output_on_error: true)
 ```
 
 either:
 
 ```ruby
-cmd.run('failing_command')
+cmd.run("failing_command")
 ```
 
 will also print the output.
@@ -251,7 +271,7 @@ Sometimes it can be useful to put your script into a "dry run" mode that prints
 
 ```ruby
 cmd = TTY::Command.new(dry_run: true)
-cmd.run(:rm, 'all_my_files')
+cmd.run(:rm, "all_my_files")
 # => [123abc] (dry run) rm all_my_files
 ```
 
@@ -266,7 +286,7 @@ cmd.dry_run? # => true
 If you need to wait for a long running script and stop it when a given pattern has been matched use `wait` like so:
 
 ```ruby
-cmd.wait 'tail -f /var/log/production.log', /something happened/
+cmd.wait "tail -f /var/log/production.log", /something happened/
 ```
 
 ### 2.6 Test
@@ -274,7 +294,7 @@ cmd.wait 'tail -f /var/log/production.log', /something happened/
 To simulate classic bash test command you case use `test` method with expression to check as a first argument:
 
 ```ruby
-if cmd.test '-e /etc/passwd'
+if cmd.test "-e /etc/passwd"
   puts "Sweet..."
 else
   puts "Ohh no! Where is it?"
@@ -297,24 +317,24 @@ cmd.ruby %q{-e "puts 'Hello world'"}
 The environment variables need to be provided as hash entries, that can be set directly as a first argument:
 
 ```ruby
-cmd.run({'RAILS_ENV' => 'PRODUCTION'}, :rails, 'server')
+cmd.run({"RAILS_ENV" => "PRODUCTION"}, :rails, "server")
 ```
 
 or as an option with `:env` key:
 
 ```ruby
-cmd.run(:rails, 'server', env: {rails_env: :production})
+cmd.run(:rails, "server", env: {rails_env: :production})
 ```
 
 When a value in env is nil, the variable is unset in the child process:
 
 ```ruby
-cmd.run(:echo, 'hello', env: {foo: 'bar', baz: nil})
+cmd.run(:echo, "hello", env: {foo: "bar", baz: nil})
 ```
 
 ### 3.2 Options
 
-When a hash is given in the last argument (options), it allows to specify a current directory, umask, user, group and and zero or more fd redirects for the child process.
+When a hash is given in the last argument (options), it allows to specify a current directory, umask, user, group and zero or more fd redirects for the child process.
 
 #### 3.2.1 Redirection
 
@@ -347,27 +367,27 @@ The hash key and value specify a file descriptor in the child process (stderr &
 You can also redirect to a file:
 
 ```ruby
-cmd.run(:cat, :in => 'file')
-cmd.run(:cat, :in => open('/etc/passwd'))
-cmd.run(:ls, :out => 'log')
+cmd.run(:cat, :in => "file")
+cmd.run(:cat, :in => open("/etc/passwd"))
+cmd.run(:ls, :out => "log")
 cmd.run(:ls, :out => "/dev/null")
-cmd.run(:ls, :out => 'out.log', :err => "err.log")
+cmd.run(:ls, :out => "out.log", :err => "err.log")
 cmd.run(:ls, [:out, :err] => "log")
-cmd.run("ls 1>&2", :err => 'log')
+cmd.run("ls 1>&2", :err => "log")
 ```
 
 It is possible to specify flags and permissions of file creation explicitly by passing an array value:
 
 ```ruby
-cmd.run(:ls, :out => ['log', 'w']) # 0664 assumed
-cmd.run(:ls, :out => ['log', 'w', 0600])
-cmd.run(:ls, :out => ['log', File::WRONLY|File::EXCL|File::CREAT, 0600])
+cmd.run(:ls, :out => ["log", "w"]) # 0664 assumed
+cmd.run(:ls, :out => ["log", "w", 0600])
+cmd.run(:ls, :out => ["log", File::WRONLY|File::EXCL|File::CREAT, 0600])
 ```
 
 You can, for example, read data from one source and output to another:
 
 ```ruby
-cmd.run("cat", :in => "Gemfile", :out => 'gemfile.log')
+cmd.run("cat", :in => "Gemfile", :out => "gemfile.log")
 ```
 
 #### 3.2.2 Handling Input
@@ -382,7 +402,7 @@ puts "Your name: #{name}"
 In order to execute `cli` with name input do:
 
 ```ruby
-cmd.run('cli', input: "Piotr\n")
+cmd.run("cli", input: "Piotr\n")
 # => Your name: Piotr
 ```
 
@@ -401,7 +421,7 @@ cmd.run("my_cli_program", "login", in: in_stream).out
 
 #### 3.2.3 Timeout
 
-You can timeout command execuation by providing the `:timeout` option in seconds:
+You can timeout command execution by providing the `:timeout` option in seconds:
 
 ```ruby
 cmd.run("while test 1; sleep 1; done", timeout: 5)
@@ -431,7 +451,7 @@ cmd = TTY::Command.new(binmode: true)
 
 #### 3.2.5 Signal
 
-You can specify process termination signal other than the defaut `SIGTERM`:
+You can specify process termination signal other than the default `SIGTERM`:
 
 ```ruby
 cmd.run("whilte test1; sleep1; done", timeout: 5, signal: :KILL)
@@ -469,14 +489,14 @@ However, in `interactive` mode with `pty` flag on:
 cmd.run("git log", pty: true) # => uses pager and waits for user input (never returns)
 ```
 
-In addition, when pty device is used, any input to command may be echoed to the standard output, as well as some redirets may not work.
+In addition, when pty device is used, any input to command may be echoed to the standard output, as well as some redirects may not work.
 
 #### 3.2.7 Current directory
 
 To change directory in which the command is run pass the `:chdir` option:
 
 ```ruby
-cmd.run(:echo, 'hello', chdir: '/var/tmp')
+cmd.run(:echo, "hello", chdir: "/var/tmp")
 ```
 
 #### 3.2.8 User
@@ -484,7 +504,7 @@ cmd.run(:echo, 'hello', chdir: '/var/tmp')
 To run command as a given user do:
 
 ```ruby
-cmd.run(:echo, 'hello', user: 'piotr')
+cmd.run(:echo, "hello", user: "piotr")
 ```
 
 #### 3.2.9 Group
@@ -492,7 +512,7 @@ cmd.run(:echo, 'hello', user: 'piotr')
 To run command as part of group do:
 
 ```ruby
-cmd.run(:echo, 'hello', group: 'devs')
+cmd.run(:echo, "hello", group: "devs")
 ```
 
 #### 3.2.10 Umask
@@ -500,7 +520,7 @@ cmd.run(:echo, 'hello', group: 'devs')
 To run command with umask do:
 
 ```ruby
-cmd.run(:echo, 'hello', umask: '007')
+cmd.run(:echo, "hello", umask: "007")
 ```
 
 ### 3.3 Result
@@ -508,13 +528,13 @@ cmd.run(:echo, 'hello', umask: '007')
 Each time you run command the stdout and stderr are captured and return as result. The result can be examined directly by casting it to tuple:
 
 ```ruby
-out, err = cmd.run(:echo, 'Hello')
+out, err = cmd.run(:echo, "Hello")
 ```
 
 However, if you want to you can defer reading:
 
 ```ruby
-result = cmd.run(:echo, 'Hello')
+result = cmd.run(:echo, "Hello")
 result.out
 result.err
 ```
@@ -524,7 +544,7 @@ result.err
 To check if command exited successfully use `success?`:
 
 ```ruby
-result = cmd.run(:echo, 'Hello')
+result = cmd.run(:echo, "Hello")
 result.success? # => true
 ```
 
@@ -533,7 +553,7 @@ result.success? # => true
 To check if command exited unsuccessfully use `failure?` or `failed?`:
 
 ```ruby
-result = cmd.run(:echo, 'Hello')
+result = cmd.run(:echo, "Hello")
 result.failure?  # => false
 result.failed?   # => false
 ```
@@ -543,7 +563,7 @@ result.failed?   # => false
 To check if command ran to completion use `exited?` or `complete?`:
 
 ```ruby
-result = cmd.run(:echo, 'Hello')
+result = cmd.run(:echo, "Hello")
 result.exited?    # => true
 result.complete?  # => true
 ```
@@ -553,7 +573,7 @@ result.complete?  # => true
 The result itself is an enumerable and allows you to iterate over the stdout output:
 
 ```ruby
-result = cmd.run(:ls, '-1')
+result = cmd.run(:ls, "-1")
 result.each { |line| puts line }
 # =>
 #  CHANGELOG.md
@@ -576,26 +596,29 @@ TTY::Command.record_separator = "\n\r"
 or configured per `each` call by passing delimiter as an argument:
 
 ```ruby
-cmd.run(:ls, '-1').each("\t") { ... }
+cmd.run(:ls, "-1").each("\t") { ... }
 ```
 
 ### 3.4 Custom printer
 
-If the built-in printers do not meet your requirements you can create your own. At the very minimum you need to specify the `write` method that will be called during the lifecycle of command execution:
+If the built-in printers do not meet your requirements you can create your own. A printer is a regular Ruby class that can be registered through `:printer` option to receive notifications about received command data.
+
+As the command runs the custom printer will be notified when the command starts, when data is printed to stdout, when data is printed to stderr and when the command exits.
+
+Please see [lib/tty/command/printers/abstract.rb](https://github.com/piotrmurach/tty-command/blob/master/lib/tty/command/printers/abstract.rb) for a full set of methods that you can override.
+
+At the very minimum you need to specify the `write` method that will be called during the lifecycle of command execution. The `write` accepts two arguments, first the currently run command instance and second the message to be printed:
 
 ```ruby
 CustomPrinter < TTY::Command::Printers::Abstract
-  def write(message)
-    puts message
+  def write(cmd, message)
+    puts cmd.to_command + message
   end
 end
 
-printer = CustomPrinter
-
-cmd = TTY::Command.new(printer: printer)
+cmd = TTY::Command.new(printer: CustomPrinter)
 ```
 
-
 ## 4. Example
 
 Here's a slightly more elaborate example to illustrate how tty-command can improve on plain old shell scripts. This example installs a new version of Ruby on an Ubuntu machine.
@@ -635,4 +658,4 @@ The gem is available as open source under the terms of the [MIT License](http://
 
 ## Copyright
 
-Copyright (c) 2016-2018 Piotr Murach. See LICENSE for further details.
+Copyright (c) 2016 Piotr Murach. See LICENSE for further details.