tty 0.1.3 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: ad0efdc965bc3c933d7cb71d0bf75a5be2c3bf45
-  data.tar.gz: f4e7b12fbe37bce6cc467730a472112ca673ae36
+  metadata.gz: adb46f2f2927f1568a05f2bd72a95716463b325b
+  data.tar.gz: 9d51b87df30a5743b6c72685685e085fe52f4d4d
 SHA512:
-  metadata.gz: 0045cfb5de1675a6485681b047f6cf5e785e1758b6fca908bf84a943d199f8ed2e77ba8cb0239f8dc810f07cea551ae565b485849c395e1e9fa7ed1de62bcb79
-  data.tar.gz: 103f2d9010887f3b658f97f901df315deebe80f54248950818322477d0aea36f779a2ab93ce633c504f96491649feec324bce45d946402ebed729c81eabdd561
+  metadata.gz: b759a9417dd3cdd4ecc2f306b07eb9e47479e45bd4d5d54669157ef357491e55f6bc2c32cb061c9e6e6f31d3a85b21904e7665a6d9decfc8f2e991e93718562e
+  data.tar.gz: 444c56543b529c9e22b5b90b557a0398be12c2270223d7b97dc4732972380ea7838a9897e6a2a0d50a8ada2e34390e60f38a7c6f3240640ffba57539c0073204

data/CHANGELOG.md

@@ -1,3 +1,9 @@
+0.2.0 (July 6, 2015)
+
+* Extract platform detection as dependency on tty-platform
+* Extract terminal output paging as dependency on tty-pager
+* Extract which command as dependency on tty-which
+
 0.1.3 (April 3, 2015)
 
 * Add table rendering as dependency on tty-table

data/Gemfile

@@ -3,15 +3,15 @@ source 'https://rubygems.org'
 gemspec
 
 group :development do
-  gem 'rake',    '~> 10.1.0'
-  gem 'rspec',   '~> 3.1.0'
+  gem 'rake',    '~> 10.4.2'
+  gem 'rspec',   '~> 3.2.0'
   gem 'yard',    '~> 0.8.7'
   gem 'timecop', '~> 0.7.1'
 end
 
 group :metrics do
-  gem 'coveralls', '~> 0.7.0'
-  gem 'simplecov', '~> 0.8.2'
+  gem 'coveralls', '~> 0.8.1'
+  gem 'simplecov', '~> 0.10.0'
   gem 'yardstick', '~> 0.9.9'
   gem 'reek',      '~> 1.3.7'
 end

data/README.md

@@ -1,10 +1,10 @@
 # [![Application icon](https://github.com/peter-murach/tty/raw/master/images/tty.png)][icon]
 [icon]: http://peter-murach.github.io/tty/
-[![Gem Version](https://badge.fury.io/rb/tty.png)][gem]
-[![Build Status](https://secure.travis-ci.org/peter-murach/tty.png?branch=master)][travis]
-[![Code Climate](https://codeclimate.com/github/peter-murach/tty.png)][codeclimate]
-[![Coverage Status](https://coveralls.io/repos/peter-murach/tty/badge.png?branch=master)][coveralls]
-[![Inline docs](http://inch-ci.org/github/peter-murach/tty.png?branch=master)][inchpages]
+[![Gem Version](https://badge.fury.io/rb/tty.svg)][gem]
+[![Build Status](https://secure.travis-ci.org/peter-murach/tty.svg?branch=master)][travis]
+[![Code Climate](https://codeclimate.com/github/peter-murach/tty/badges/gpa.svg)][codeclimate]
+[![Coverage Status](https://coveralls.io/repos/peter-murach/tty/badge.svg?branch=master)][coveralls]
+[![Inline docs](http://inch-ci.org/github/peter-murach/tty.svg?branch=master)][inchpages]
 [![Gitter](https://badges.gitter.im/Join Chat.svg)][gitter]
 
 [gem]: http://badge.fury.io/rb/tty
@@ -57,17 +57,18 @@ Or install it yourself as:
 
 ## Contents
 
-* [1. Table](#1-table)
-* [2. Color](#2-color)
-* [3. ProgressBar](#3-progressbar)
-* [4. Spinner](#4-spinner)
-* [5. Screen](#5-screen)
-* [6. Terminal](#6-terminal)
-  * [6.1 Pager](#61-pager)
-* [7. Shell](#7-shell)
-* [8. System](#8-system)
+* [1. Overview](#1-overview)
+* [2. Drawing tables](#2-drawing-tables)
+* [3. Drawing progress bars](#3-drawing-progress-bars)
+* [4. Drawing spinners](#4-drawing-spinners)
+* [5. Output coloring](#5-output-coloring)
+* [6. Output paging](#6-output-paging)
+* [7. Detecting screen properties](#7-detecting-screen-properties)
+* [8. Detecting platform](#8-detecting-platform)
+* [9. Searching executables](#9-searching-executables)
+* [10. Prompting for input](#10-prompting-for-input)
 
-## Usage
+## 1. Overview
 
 **TTY** provides you with many tools to get the job done in terminal.
 
@@ -110,7 +111,7 @@ screen.width    # => 280
 screen.height   # => 51
 ```
 
-## 1. Table
+## 2. Drawing tables
 
 **TTY** uses the [tty-table](https://github.com/peter-murach/tty-table) component in order to convert data into table and render as string output in tabular form. For example, to render data with ASCII border:
 
@@ -128,20 +129,11 @@ table.render(:ascii)
 
 Please refer to [documentation](https://github.com/peter-murach/tty-table) for complete API.
 
-## 2. Color
+## 3. Drawing progress bars
 
-In order to colorize your output **TTY** uses the [pastel](https://github.com/peter-murach/pastel) component like so:
-
-```ruby
-pastel = Pastel.new
-pastel.red.on_green.bold 'text...'  # => red bold text on green background
-```
-
-Please refer to [documentation](https://github.com/peter-murach/pastel) for complete API.
+In order to draw progress bars in terminal, **TTY** uses the [tty-progressbar](https://github.com/peter-murach/tty-progressbar) component.
 
-## 3. ProgressBar
-
-In order to draw progress bar **TTY** uses the [tty-progressbar](https://github.com/peter-murach/tty-progressbar) component. For example, to render basic download bar do:
+For example, to render basic download bar do:
 
 ```ruby
 bar = TTY::ProgressBar.new("downloading [:bar]", total: 30)
@@ -150,7 +142,7 @@ bar = TTY::ProgressBar.new("downloading [:bar]", total: 30)
 
 Please refer to [documentation](https://github.com/peter-murach/tty-progressbar) for complete API.
 
-## 4. Spinner
+## 4. Drawing spinners
 
 **TTY** uses the [tty-spinner](https://github.com/peter-murach/tty-spinner) component to handle terminal spinning animation. For instance, to create a simple spinner do:
 
@@ -161,9 +153,35 @@ spinner = TTY::Spinner.new('Loading ... ', format: :spin_2)
 
 Please refer to [documentation](https://github.com/peter-murach/tty-spinner) for complete API.
 
-## 5. Screen
+## 5. Output coloring
+
+In order to colorize your output **TTY** uses the [pastel](https://github.com/peter-murach/pastel) component like so:
+
+```ruby
+pastel = Pastel.new
+pastel.red.on_green.bold 'text...'  # => red bold text on green background
+```
+
+Please refer to [documentation](https://github.com/peter-murach/pastel) for complete API.
+
+## 6. Output paging
 
-**TTY** uses the [tty-screen](https://github.com/peter-murach/tty-screen) component to measure the screen properties. For example to get screen size do:
+To page terminal output **TTY** relies on [tty-pager](https://github.com/peter-murach/tty-pager) component.
+
+For example to page terminal output do (on non unix systems falls back to ruby implementation):
+
+```ruby
+pager = TTY::Pager.new
+pager.page('Very long text...')
+```
+
+Please refer to [documentation](https://github.com/peter-murach/tty-pager) for complete API.
+
+## 7. Detecting screen properties
+
+**TTY** uses the [tty-screen](https://github.com/peter-murach/tty-screen) component to measure the screen properties.
+
+For example to get screen size do:
 
 ```ruby
 screen = TTY::Screen.new
@@ -174,25 +192,39 @@ screen.height   # => 51
 
 Please refer to [documentation](https://github.com/peter-murach/tty-screen) for complete API.
 
-## 6 Terminal
+## 8. Detecting platform
 
-To read general terminal properties you can use on of the helpers
+To check for platform properties **TTY** uses [tty-platform](https://github.com/peter-murach/tty-platform) component.
 
 ```ruby
-term = TTY::Terminal.new
-term.echo(false) { }    # switch off echo for the block
-term.page               # page terminal output, on non unix systems falls back to ruby implementation
+platform = TTY::Platform.new
+platform.cpu     # => 'x86_64'
+platform.os      # => 'darwin'
+platform.version # => '10.6.1'
 ```
 
-### 6.1 Pager
+In addition, there are more generic utilities to check for type of operating system:
 
-To page your output do
+```
+TTY::Platform.unix?    # => true
+TTY::Platform.windows? # => false
+```
+
+Please refer to [documentation](https://github.com/peter-murach/tty-platform) for complete API.
+
+## 9. Searching executables
+
+To find executable path **TTY** uses [tty-which](https://github.com/peter-murach/tty-which#ttywhich) component.
+
+For instance, to find out if `less` utility is actually supported by the system do:
 
 ```ruby
-term.page 'long text...'
+TTY::Which.which('less')  # => '/usr/bin/less'
 ```
 
-## 7 Shell
+Please refer to [documentation](https://github.com/peter-murach/tty-which) for complete API.
+
+## 10. Prompting for input
 
 Main responsibility is to interact with the prompt and provide convenience methods.
 
@@ -291,16 +323,9 @@ shell.suggest('sta', ['stage', 'stash', 'commit', 'branch'])
           stash
 ```
 
-## 8 System
-
-```ruby
-TTY::System.unix?        # check if unix platform
-TTY::System.windows?     # check if windows platform
 TTY::System.which(cmd)   # full path to executable if found, nil otherwise
 TTY::System.exists?(cmd) # check if command is available
 TTY::System.editor       # provides access to system editor
-```
-
 To set preferred editor you can either use shell environment variables such as `EDITOR` and `VISUAL` or set the command(s) manually like so
 
 ```ruby

data/lib/tty.rb

@@ -3,10 +3,13 @@
 require 'equatable'
 require 'pastel'
 require 'necromancer'
+require 'tty-pager'
+require 'tty-platform'
+require 'tty-progressbar'
 require 'tty-screen'
 require 'tty-spinner'
-require 'tty-progressbar'
 require 'tty-table'
+require 'tty-which'
 
 require 'tty/version'
 
@@ -37,11 +40,7 @@ require 'tty/shell/response'
 require 'tty/terminal/echo'
 require 'tty/terminal/raw'
 require 'tty/terminal/home'
-require 'tty/terminal/pager'
-require 'tty/terminal/pager/basic'
-require 'tty/terminal/pager/system'
 
-require 'tty/system/which'
 require 'tty/system/editor'
 
 module TTY

data/lib/tty/system.rb

@@ -1,55 +1,7 @@
 # encoding: utf-8
 
-require 'rbconfig'
-
 module TTY
   class System
-    # Check if windows platform.
-    #
-    # @return [Boolean]
-    #
-    # @api public
-    def self.windows?
-      match_os?(/msdos|mswin|djgpp|mingw|windows/i)
-    end
-
-    # Check if unix platform
-    #
-    # @return [Boolean]
-    #
-    # @api public
-    def self.unix?
-      match_os?(/(aix|darwin|linux|(net|free|open)bsd|cygwin|solaris|irix|hpux)/i)
-    end
-
-    # Check if platform matches given systems
-    #
-    # @return [Boolean]
-    #
-    # @api public
-    def self.match_os?(matcher)
-      !!(RbConfig::CONFIG['host_os'] =~ matcher)
-    end
-
-    # Find an executable in the PATH
-    #
-    # @see TTY::System::Which
-    #
-    # @api public
-    def self.which(command)
-      Which.new(command).which
-    end
-
-    # Check if command is available
-    #
-    # @param [String] name
-    #   the command name
-    #
-    # @api public
-    def self.exists?(name)
-      !!which(name)
-    end
-
     # Proxy to editor object
     #
     # @return [TTY::System::Editor]

data/lib/tty/terminal.rb

@@ -9,13 +9,6 @@ module TTY
     # @api public
     attr_reader :color
 
-    # Output pager
-    #
-    # @return [TTY::Terminal::Pager]
-    #
-    # @api public
-    attr_reader :pager
-
     # Initialize a Terminal
     #
     # @api public
@@ -23,7 +16,6 @@ module TTY
       @color = Pastel.new
       @echo  = TTY::Terminal::Echo.new
       @raw   = TTY::Terminal::Raw.new
-      @pager = TTY::Terminal::Pager
       @home  = Home.new
     end
 
@@ -81,15 +73,5 @@ module TTY
     def home
       @home.home
     end
-
-    # Run text through a dynamically chosen pager
-    #
-    # @param [String] text
-    #   the text to page
-    #
-    # @api public
-    def page(text)
-      @pager.page(text)
-    end
   end # Terminal
 end # TTY

data/lib/tty/terminal/echo.rb

@@ -8,14 +8,14 @@ module TTY
       #
       # @api public
       def on
-        %x{stty echo} if TTY::System.unix?
+        %x{stty echo} if TTY::Platform.unix?
       end
 
       # Turn echo off
       #
       # @api public
       def off
-        %x{stty -echo} if TTY::System.unix?
+        %x{stty -echo} if TTY::Platform.unix?
       end
 
       # Wrap code block inside echo

data/lib/tty/terminal/raw.rb

@@ -8,14 +8,14 @@ module TTY
       #
       # @api public
       def on
-        %x{stty raw} if TTY::System.unix?
+        %x{stty raw} if TTY::Platform.unix?
       end
 
       # Turn raw mode off
       #
       # @api public
       def off
-        %x{stty -raw} if TTY::System.unix?
+        %x{stty -raw} if TTY::Platform.unix?
       end
 
       # Wrap code block inside raw mode

data/lib/tty/version.rb

@@ -1,5 +1,5 @@
 # encoding: utf-8
 
 module TTY
-  VERSION = "0.1.3"
+  VERSION = "0.2.0"
 end # TTY

data/tty.gemspec

@@ -17,10 +17,13 @@ Gem::Specification.new do |gem|
   gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
   gem.require_paths = ["lib"]
 
-  gem.add_dependency 'tty-table',       '~> 0.2.0'
-  gem.add_dependency 'tty-progressbar', '~> 0.5.0'
-  gem.add_dependency 'tty-screen',      '~> 0.1.0'
+  gem.add_dependency 'tty-pager',       '~> 0.2.0'
+  gem.add_dependency 'tty-platform',    '~> 0.1.0'
+  gem.add_dependency 'tty-progressbar', '~> 0.6.0'
+  gem.add_dependency 'tty-screen',      '~> 0.2.0'
   gem.add_dependency 'tty-spinner',     '~> 0.1.0'
+  gem.add_dependency 'tty-table',       '~> 0.3.0'
+  gem.add_dependency 'tty-which',       '~> 0.1.0'
   gem.add_dependency 'equatable',       '~> 0.5.0'
   gem.add_dependency 'necromancer',     '~> 0.3.0'
   gem.add_dependency 'pastel',          '~> 0.4.0'

metadata

@@ -1,17 +1,17 @@
 --- !ruby/object:Gem::Specification
 name: tty
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.2.0
 platform: ruby
 authors:
 - Piotr Murach
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-04-03 00:00:00.000000000 Z
+date: 2015-07-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: tty-table
+  name: tty-pager
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
@@ -24,22 +24,50 @@ dependencies:
     - - ~>
       - !ruby/object:Gem::Version
         version: 0.2.0
+- !ruby/object:Gem::Dependency
+  name: tty-platform
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.1.0
 - !ruby/object:Gem::Dependency
   name: tty-progressbar
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 0.5.0
+        version: 0.6.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 0.5.0
+        version: 0.6.0
 - !ruby/object:Gem::Dependency
   name: tty-screen
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+- !ruby/object:Gem::Dependency
+  name: tty-spinner
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
@@ -53,7 +81,21 @@ dependencies:
       - !ruby/object:Gem::Version
         version: 0.1.0
 - !ruby/object:Gem::Dependency
-  name: tty-spinner
+  name: tty-table
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.3.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.3.0
+- !ruby/object:Gem::Dependency
+  name: tty-which
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
@@ -162,13 +204,9 @@ files:
 - lib/tty/support/utils.rb
 - lib/tty/system.rb
 - lib/tty/system/editor.rb
-- lib/tty/system/which.rb
 - lib/tty/terminal.rb
 - lib/tty/terminal/echo.rb
 - lib/tty/terminal/home.rb
-- lib/tty/terminal/pager.rb
-- lib/tty/terminal/pager/basic.rb
-- lib/tty/terminal/pager/system.rb
 - lib/tty/terminal/raw.rb
 - lib/tty/vector.rb
 - lib/tty/version.rb
@@ -221,19 +259,9 @@ files:
 - spec/tty/system/editor/executables_spec.rb
 - spec/tty/system/editor/invoke_spec.rb
 - spec/tty/system/editor/open_spec.rb
-- spec/tty/system/platform_spec.rb
-- spec/tty/system/which/which_spec.rb
-- spec/tty/system/which_spec.rb
 - spec/tty/terminal/color_spec.rb
 - spec/tty/terminal/echo_spec.rb
 - spec/tty/terminal/home_spec.rb
-- spec/tty/terminal/page_spec.rb
-- spec/tty/terminal/pager/available_spec.rb
-- spec/tty/terminal/pager/basic/page_spec.rb
-- spec/tty/terminal/pager/command_spec.rb
-- spec/tty/terminal/pager/executables_spec.rb
-- spec/tty/terminal/pager/page_spec.rb
-- spec/tty/terminal/pager/system/page_spec.rb
 - spec/tty/tty_spec.rb
 - spec/tty/vector/new_spec.rb
 - tasks/console.rake
@@ -319,19 +347,9 @@ test_files:
 - spec/tty/system/editor/executables_spec.rb
 - spec/tty/system/editor/invoke_spec.rb
 - spec/tty/system/editor/open_spec.rb
-- spec/tty/system/platform_spec.rb
-- spec/tty/system/which/which_spec.rb
-- spec/tty/system/which_spec.rb
 - spec/tty/terminal/color_spec.rb
 - spec/tty/terminal/echo_spec.rb
 - spec/tty/terminal/home_spec.rb
-- spec/tty/terminal/page_spec.rb
-- spec/tty/terminal/pager/available_spec.rb
-- spec/tty/terminal/pager/basic/page_spec.rb
-- spec/tty/terminal/pager/command_spec.rb
-- spec/tty/terminal/pager/executables_spec.rb
-- spec/tty/terminal/pager/page_spec.rb
-- spec/tty/terminal/pager/system/page_spec.rb
 - spec/tty/tty_spec.rb
 - spec/tty/vector/new_spec.rb
 has_rdoc: 

data/lib/tty/system/which.rb

@@ -1,51 +0,0 @@
-# encoding: utf-8
-
-module TTY
-  class System
-    # A class responsible for finding an executable in the PATH
-    class Which
-      # The command to find
-      attr_reader :command
-
-      # Initialize a Which
-      #
-      # @param [String] command
-      #   the command to find
-      #
-      # @api public
-      def initialize(command)
-        @command = command
-      end
-
-      # Find an executable in the PATH
-      #
-      # @param [String] command
-      #   the command to search in the PATH
-      #
-      # @example
-      #   which("ruby")  # => /usr/local/bin/ruby
-      #
-      # @return [String]
-      #   the full path to executable if found, `nil` otherwise
-      #
-      # @api public
-      def which
-        exts = ENV['PATHEXT'] ? ENV['PATHEXT'].split(';') : ['']
-        default_system_path.each do |path|
-          exts.each do |ext|
-            exec = File.join("#{path}", "#{command}#{ext}")
-            return exec if File.executable? exec
-          end
-        end
-        nil
-      end
-
-      # Find default system paths
-      #
-      # @api private
-      def default_system_path
-        ENV['PATH'].split(File::PATH_SEPARATOR)
-      end
-    end # Which
-  end # System
-end # TTY

data/lib/tty/terminal/pager.rb

@@ -1,96 +0,0 @@
-# encoding: utf-8
-
-module TTY
-  class Terminal
-    # A class responsible for paging text inside terminal
-    class Pager
-
-      attr_accessor :enabled
-
-      attr_reader :text
-
-      @command = nil
-
-      # Initialize a Pager
-      #
-      # @param [String] text
-      #   the text to page
-      #
-      # @api public
-      def initialize(text = nil)
-        @text    = text
-        @enabled = true
-      end
-
-      # Check if pager is enabled
-      #
-      # @return [Boolean]
-      #
-      # @api public
-      def enabled?
-        !!@enabled
-      end
-
-      # List possible executables for output paging
-      #
-      # @return [Array[String]]
-      #
-      # @api private
-      def self.executables
-        [ENV['GIT_PAGER'], `git config --get-all core.pager`.split.first,
-         ENV['PAGER'], 'less -isr', 'more', 'cat', 'pager']
-      end
-
-      # Find first available system command for paging
-      #
-      # @param [Array[String]] commands
-      #
-      # @return [String]
-      #
-      # @api public
-      def self.available(*commands)
-        commands = commands.empty? ? executables : commands
-        commands.compact.uniq.find { |cmd| System.exists?(cmd) }
-      end
-
-      # Check if paging command exists
-      #
-      # @api private
-      def self.available?
-        !!available
-      end
-
-      # Finds command to execute pager from shell commands
-      # unless configured is provided.
-      #
-      # @param [Array[String]] commands
-      #
-      # @return [String]
-      #
-      # @api private
-      def self.command(*commands)
-        @command = if @command && commands.empty?
-          @command
-        else
-          available(*commands)
-        end
-      end
-
-      # Pages output using configured pager
-      #
-      # @param [String] text
-      #   the text to page
-      #
-      # @api public
-      def self.page(text)
-        return unless TTY.shell.tty?
-
-        if System.unix? && available?
-          SystemPager.new(text).page
-        else
-          BasicPager.new(text).page
-        end
-      end
-    end # Pager
-  end # Terminal
-end # TTY

data/lib/tty/terminal/pager/basic.rb

@@ -1,49 +0,0 @@
-# encoding: utf-8
-
-module TTY
-  class Terminal
-    # A class responsible for paging text
-    class BasicPager < Pager
-      PROMPT_HEIGHT = 3
-
-      PAGE_BREAK = '--- Press enter/return to continue (or q to quit) ---'
-
-      # Use ruby to page output text
-      #
-      # @api public
-      def page
-        text_lines = text.lines.to_a
-
-        text_lines.each_slice(page_size) do |chunk|
-          TTY.shell.say chunk.join
-          break if chunk.size < page_size
-          break if !continue?(text_lines)
-        end
-      end
-
-      private
-
-      # Check whether to progress with paging
-      #
-      # @param [Array[String]] text_lines
-      #
-      # @return [Boolean]
-      #
-      # @api private
-      def continue?(text_lines)
-        if text_lines.size > page_size
-          question = TTY.shell.ask "\n#{PAGE_BREAK}"
-          return false if question.read_string[/q/i]
-        end
-        true
-      end
-
-      # Determine current page size
-      #
-      # @api private
-      def page_size
-        @page_size ||= TTY.terminal.height - PROMPT_HEIGHT
-      end
-    end # BasicPager
-  end # Terminal
-end # TTY

data/lib/tty/terminal/pager/system.rb

@@ -1,36 +0,0 @@
-# encoding: utf-8
-
-module TTY
-  class Terminal
-    # A class responsible for paging text
-    class SystemPager < Pager
-      # Use system command to page output text
-      #
-      # @api public
-      def page
-        read_io, write_io = IO.pipe
-
-        if Kernel.fork
-          # parent process
-          TTY.shell.input.reopen(read_io)
-          read_io.close
-          write_io.close
-
-          # Wait until we have input before we start the pager
-          Kernel.select [TTY.shell.stdin]
-
-          begin
-            Kernel.exec(Pager.command)
-          rescue
-            Kernel.exec '/bin/sh', '-c', command
-          end
-        else
-          # child process
-          write_io.write(text)
-          write_io.close
-          read_io.close
-        end
-      end
-    end # SystemPager
-  end # Terminal
-end # TTY

data/spec/tty/system/platform_spec.rb

@@ -1,46 +0,0 @@
-# encoding: utf-8
-
-require 'spec_helper'
-
-describe TTY::System, '#platform' do
-  subject(:system) { described_class }
-
-  it { is_expected.to respond_to(:windows?) }
-
-  it { is_expected.to respond_to(:unix?) }
-
-  it { is_expected.to respond_to(:which) }
-
-  it { is_expected.to respond_to(:exists?) }
-
-  it { is_expected.to respond_to(:editor) }
-
-  context 'windows?' do
-    it 'is on windows' do
-      allow(RbConfig::CONFIG).to receive(:[]).with('host_os').and_return('windows')
-      expect(system.windows?).to eq(true)
-    end
-
-    it 'is on windows ignoring case' do
-      allow(RbConfig::CONFIG).to receive(:[]).with('host_os').and_return('Windows')
-      expect(system.windows?).to eq(true)
-    end
-
-    it 'is not on windows' do
-      allow(RbConfig::CONFIG).to receive(:[]).with('host_os').and_return('unknown')
-      expect(system.windows?).to eq(false)
-    end
-  end
-
-  context 'unix?' do
-    it 'checks if unix' do
-      allow(RbConfig::CONFIG).to receive(:[]).with('host_os').and_return('darwin')
-      expect(system.unix?).to eq(true)
-    end
-
-    it 'checks if unix' do
-      allow(RbConfig::CONFIG).to receive(:[]).with('host_os').and_return('unknown')
-      expect(system.unix?).to eq(false)
-    end
-  end
-end

data/spec/tty/system/which/which_spec.rb

@@ -1,48 +0,0 @@
-# encoding: utf-8
-
-require 'spec_helper'
-
-describe TTY::System::Which, '#which' do
-  let(:path) { "/usr/local/bin:/usr/local/git/bin" }
-  let(:extension) { '.bat' }
-
-  subject { described_class.new(command) }
-
-  context 'without extension' do
-    let(:command)  { 'ruby' }
-
-    before {
-      allow(ENV).to receive(:[]).with('PATHEXT').and_return(nil)
-      allow(ENV).to receive(:[]).with('PATH').and_return(path)
-    }
-
-    it 'finds command' do
-      allow(File).to receive(:executable?) { true }
-      expect(subject.which).to eql "/usr/local/bin/ruby"
-    end
-
-    it "doesn't find command" do
-      allow(File).to receive(:executable?) { false }
-      expect(subject.which).to be_nil
-    end
-  end
-
-  context 'with extension' do
-    let(:command) { 'ruby' }
-
-    before {
-      allow(ENV).to receive(:[]).with('PATHEXT').and_return(extension)
-      allow(ENV).to receive(:[]).with('PATH').and_return(path)
-    }
-
-    it 'finds command' do
-      allow(File).to receive(:executable?) { true }
-      expect(subject.which).to eql "/usr/local/bin/ruby.bat"
-    end
-
-    it "doesn't find command" do
-      allow(File).to receive(:executable?) { false }
-      expect(subject.which).to be_nil
-    end
-  end
-end

data/spec/tty/system/which_spec.rb

@@ -1,15 +0,0 @@
-# encoding: utf-8
-
-require 'spec_helper'
-
-describe TTY::System, '#which' do
-  let(:command) { 'ruby' }
-  let(:which)   { double(:which, :which => command) }
-
-  subject(:system) { described_class }
-
-  it 'seeks system command' do
-    allow(TTY::System::Which).to receive(:new).with(command).and_return(which)
-    expect(system.which(command)).to eql(command)
-  end
-end

data/spec/tty/terminal/page_spec.rb

@@ -1,14 +0,0 @@
-# encoding: utf-8
-
-require 'spec_helper'
-
-describe TTY::Terminal, '#page' do
-  let(:text)   { "a\n"}
-
-  subject(:terminal) { described_class.new }
-
-  it 'invokes pager page method' do
-    expect(terminal.pager).to receive(:page).with(text)
-    terminal.page(text)
-  end
-end

data/spec/tty/terminal/pager/available_spec.rb

@@ -1,40 +0,0 @@
-# encoding: utf-8
-
-require 'spec_helper'
-
-describe TTY::Terminal::Pager, '#available' do
-  let(:execs)   { ['less', 'more'] }
-  let(:system)  { TTY::System }
-  let(:command) { 'less' }
-
-  subject(:pager) { described_class }
-
-  before { allow(subject).to receive(:executables).and_return(execs) }
-
-  context 'when command exists' do
-    before {
-      allow(system).to receive(:exists?).with('less').and_return(true)
-      allow(system).to receive(:exists?).with('more').and_return(false)
-    }
-
-    it 'finds single command' do
-      expect(pager.available).to eql('less')
-    end
-  end
-
-  context 'when no command exists' do
-    before { allow(system).to receive(:exists?).and_return(false) }
-
-    it "doesn't find command" do
-      expect(pager.available).to be_nil
-    end
-  end
-
-  context 'when custom command' do
-    before { allow(system).to receive(:exists?).with(command).and_return(true) }
-
-    it "takes precedence over other commands" do
-      expect(subject.available(command)).to eql(command)
-    end
-  end
-end

data/spec/tty/terminal/pager/basic/page_spec.rb

@@ -1,54 +0,0 @@
-# encoding: utf-8
-
-require 'spec_helper'
-
-describe TTY::Terminal::BasicPager, '#simple' do
-  let(:input)    { StringIO.new }
-  let(:output)   { StringIO.new }
-  let(:shell)    { TTY::Shell.new(input, output) }
-  let(:terminal) { TTY.terminal }
-  let(:object)   { described_class }
-
-  subject(:pager) { object.new(text) }
-
-  before {
-    allow(TTY).to receive(:shell).and_return(shell)
-    allow(terminal).to receive(:height).and_return(10)
-  }
-
-  context 'when no text' do
-    let(:text) { "" }
-
-    it "doesn't page text" do
-      pager.page
-      expect(output.string).to eql(text)
-    end
-  end
-
-  context 'when text fits on screen' do
-    let(:text) { "a\n" }
-
-    it "doesn't page text not long enough" do
-      pager.page
-      expect(output.string).to eql(text)
-    end
-  end
-
-  context "when text doesn't fit on screen" do
-    let(:text) { "a\na\na\na\na\na\na\na\na\na\n" }
-
-    it "continues paging when enter is pressed" do
-      input << '\n'
-      input.rewind
-      pager.page
-      expect(output.string).to eql("a\na\na\na\na\na\na\n\n#{object::PAGE_BREAK}\na\na\na\n")
-    end
-
-    it "stops paging when q is pressed" do
-      input << 'q\n'
-      input.rewind
-      pager.page
-      expect(output.string).to eql("a\na\na\na\na\na\na\n\n#{object::PAGE_BREAK}\n")
-    end
-  end
-end

data/spec/tty/terminal/pager/command_spec.rb

@@ -1,16 +0,0 @@
-# encoding: utf-8
-
-require 'spec_helper'
-
-describe TTY::Terminal::Pager, '#command' do
-  let(:pager) { 'vim' }
-
-  subject { described_class }
-
-  context 'when custom command' do
-    it 'searches available commands' do
-      expect(subject).to receive(:available).with(pager)
-      subject.command(pager)
-    end
-  end
-end

data/spec/tty/terminal/pager/executables_spec.rb

@@ -1,13 +0,0 @@
-# encoding: utf-8
-
-require 'spec_helper'
-
-describe TTY::Terminal::Pager, '#executables' do
-  let(:object) { described_class }
-
-  subject { object.executables }
-
-  it { is_expected.to be_an(Array) }
-
-  it { is_expected.to include('less -isr') }
-end

data/spec/tty/terminal/pager/page_spec.rb

@@ -1,45 +0,0 @@
-# encoding: utf-8
-
-require 'spec_helper'
-
-describe TTY::Terminal::Pager, '#page' do
-  let(:text)   { "a\n" }
-  let(:shell)  { TTY.shell }
-  let(:system) { TTY::System }
-  let(:pager)  { double(:pager, :page => nil) }
-  let(:basic_pager)  { TTY::Terminal::BasicPager }
-  let(:system_pager) { TTY::Terminal::SystemPager }
-
-  subject { described_class }
-
-  before { allow(shell).to receive(:tty?).and_return(true) }
-
-  context 'when not tty' do
-    before { allow(shell).to receive(:tty?).and_return(false) }
-
-    it "doesn't page" do
-      expect(subject.page(text)).to eql(nil)
-    end
-  end
-
-  context 'when not unix' do
-    before  { allow(system).to receive(:unix?).and_return(false) }
-
-    it 'pages with simple pager' do
-      expect(basic_pager).to receive(:new).with(text).and_return(pager)
-      subject.page(text)
-    end
-  end
-
-  context 'when unix and available' do
-    before  {
-      allow(system).to receive(:unix?).and_return(true)
-      allow(subject).to receive(:available?).and_return(true)
-    }
-
-    it 'pages with system pager' do
-      expect(system_pager).to receive(:new).with(text).and_return(pager)
-      subject.page(text)
-    end
-  end
-end

data/spec/tty/terminal/pager/system/page_spec.rb

@@ -1,29 +0,0 @@
-# encoding: utf-8
-
-require 'spec_helper'
-
-describe TTY::Terminal::SystemPager, '#simple' do
-  let(:input)    { StringIO.new }
-  let(:output)   { StringIO.new }
-  let(:shell)    { TTY::Shell.new(input, output) }
-  let(:terminal) { TTY.terminal }
-  let(:object)   { described_class }
-
-  subject(:pager) { object.new(text) }
-
-  before {
-    allow(TTY).to receive(:shell).and_return(shell)
-    allow(IO).to receive(:pipe).and_return([input, output])
-    allow(Kernel).to receive(:fork) { true }
-  }
-
-  context 'when text fits on screen' do
-    let(:text) { "a\na\na\na\na\na\na\na\na\na\n" }
-
-    it "doesn't page text not long enough" do
-      expect(Kernel).to receive(:exec)
-      expect(Kernel).to receive(:select)
-      pager.page
-    end
-  end
-end