tty-pager 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 762884b7e1c8aed7cb329a22577247b1d13e3dec
+  data.tar.gz: 3a0e5d127f2348ab58a7e95402b4a76c8cf1aea9
+SHA512:
+  metadata.gz: 9fbcf3ac3cbbbe53591bc2ced88aa28af51825e6d094f2fe22d7aa47940293f8b0fb8abca0861d98664de6b3bb7397b12477973a5599fd36aade65b8918e7d2e
+  data.tar.gz: a7632fc1596b11cd0e9a4aa9d2bde295020b856eca9e5e2f6b28aca8252d4db5228a4a7e177920851d68e8db5b1aae6f47800c3ff25af8f9ca3a3b5cc3b27594

data/.gitignore

@@ -0,0 +1,22 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log

data/.rspec

@@ -0,0 +1,3 @@
+--color
+--require spec_helper
+--warnings

data/.ruby-version

@@ -0,0 +1 @@
+2.0.0

data/.travis.yml

@@ -0,0 +1,24 @@
+language: ruby
+bundler_args: --without yard benchmarks
+script: "bundle exec rake ci"
+rvm:
+  - 1.9.3
+  - 2.0
+  - 2.1
+  - 2.2
+  - ruby-head
+matrix:
+  include:
+    - rvm: jruby-19mode
+    - rvm: jruby-20mode
+    - rvm: jruby-21mode
+    - rvm: jruby-head
+    - rvm: rbx-2
+  allow_failures:
+    - rvm: ruby-head
+    - rvm: jruby-head
+    - rvm: jruby-20mode
+    - rvm: jruby-21mode
+  fast_finish: true
+branches:
+  only: master

data/Gemfile

@@ -0,0 +1,15 @@
+source 'https://rubygems.org'
+
+gemspec
+
+group :development do
+  gem 'rake',    '~> 10.4.2'
+  gem 'rspec',   '~> 3.2.0'
+  gem 'yard',    '~> 0.8.7'
+end
+
+group :metrics do
+  gem 'coveralls', '~> 0.8.1'
+  gem 'simplecov', '~> 0.10.0'
+  gem 'yardstick', '~> 0.9.9'
+end

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2015 Piotr Murach
+
+MIT License
+
+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/README.md

@@ -0,0 +1,75 @@
+# TTY::Pager
+[![Gem Version](https://badge.fury.io/rb/tty-pager.svg)][gem]
+[![Build Status](https://secure.travis-ci.org/peter-murach/tty-pager.svg?branch=master)][travis]
+[![Code Climate](https://codeclimate.com/github/peter-murach/tty-pager/badges/gpa.svg)][codeclimate]
+[![Coverage Status](https://coveralls.io/repos/peter-murach/tty-pager/badge.svg)][coverage]
+[![Inline docs](http://inch-ci.org/github/peter-murach/tty-pager.svg?branch=master)][inchpages]
+
+[gem]: http://badge.fury.io/rb/tty-pager
+[travis]: http://travis-ci.org/peter-murach/tty-pager
+[codeclimate]: https://codeclimate.com/github/peter-murach/tty-pager
+[coverage]: https://coveralls.io/r/peter-murach/tty-pager
+[inchpages]: http://inch-ci.org/github/peter-murach/tty-pager
+
+> Terminal output paging in a cross-platform way supporting all major ruby interpreters.
+
+**TTY::Pager** provides independent terminal output paging component for [TTY](https://github.com/peter-murach/tty) toolkit.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'tty-pager'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install tty-pager
+
+## 1. Usage
+
+The **TTY::Pager** upon initialization will choose the best available pager out of `SystemPager`, `BasicPager` or `NullPager`. If paging is disabled then a `NullPager` is used that simply prints content out to stdout, otherwise a check is performed to find native system executable to perform pagination natively with `SystemPager`. If no system executable is found, a `BasicPager` is used which is a pure Ruby implementation that will work with any ruby interpreter.
+
+```ruby
+pager = TTY::Pager.new
+```
+
+Then to perform actual content pagination invoke `page` like so:
+
+```ruby
+pager.page("Very long text...")
+```
+
+If you want to use specific pager you can do so by invoking it directly
+
+```ruby
+pager = TTY::Pager::BasicPager.new
+```
+
+If you want to disable the pager pass the `:enabled` option:
+
+```ruby
+pager = TTY::Pager.new enabled: false
+```
+
+For the `BasicPager` you can also pass a `:prompt` option to change the page break content:
+
+```ruby
+prompt = -> (page_num) { output.puts "Page -#{page_num}- Press enter to continue" }
+pager = TTY::Pager::BasicPager.new prompt: prompt
+```
+
+## Contributing
+
+1. Fork it ( https://github.com/peter-murach/tty-pager/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request
+
+## Copyright
+
+Copyright (c) 2015 Piotr Murach. See LICENSE for further details.

data/Rakefile

@@ -0,0 +1,8 @@
+# coding: utf-8
+
+require 'bundler/gem_tasks'
+
+FileList['tasks/**/*.rake'].each(&method(:import))
+
+desc 'Run all specs'
+task ci: %w[ spec ]

data/lib/tty/pager/basic.rb

@@ -0,0 +1,60 @@
+# coding: utf-8
+
+module TTY
+  class Pager
+    # A basic pager is used to work on systems where
+    # system pager is not supported.
+    #
+    # @api public
+    class BasicPager < Pager
+      # Page text
+      #
+      # @api public
+      def page(text, &callback)
+        page_num = 1
+        leftover = []
+        lines_left = @height
+
+        text.lines.each do |line|
+          chunk = []
+          if !leftover.empty?
+            chunk = leftover
+            leftover = []
+          end
+          wrapped_line = Verse.wrap(line, @width)
+          wrapped_line.lines.each do |line_part|
+            if lines_left > 0
+              chunk << line_part
+              lines_left -= 1
+            else
+              leftover << line_part
+            end
+          end
+          output.print(chunk.join)
+
+          if lines_left == 0
+            break unless continue_paging?(page_num)
+            lines_left = @height
+            if leftover.size > 0
+              lines_left -= leftover.size
+            end
+            page_num += 1
+            return !callback.call(page_num) unless callback.nil?
+          end
+        end
+
+        if leftover.size > 0
+          output.print(leftover.join)
+        end
+      end
+
+      private
+
+      # @api private
+      def continue_paging?(page_num)
+        instance_exec(page_num, &@prompt)
+        !@input.gets.chomp[/q/i]
+      end
+    end # BasicPager
+  end # Pager
+end # TTY

data/lib/tty/pager/null.rb

@@ -0,0 +1,14 @@
+# coding: utf-8
+
+module TTY
+  class Pager
+    class NullPager < Pager
+      # Pass output directly to stdout
+      #
+      # @api public
+      def page(text, &callback)
+        output.puts(text)
+      end
+    end
+  end # Pager
+end # TTY

data/lib/tty/pager/system.rb

@@ -0,0 +1,124 @@
+# coding: utf-8
+
+module TTY
+  class Pager
+    # A system pager is used  on systems where native
+    # pagination exists
+    #
+    # @api public
+    class SystemPager < Pager
+      # Find first available system command for paging
+      #
+      # @example Basic usage
+      #   available # => 'less'
+      #
+      # @example Usage with commands
+      #   available('less', 'cat')  # => 'less'
+      #
+      # @param [Array[String]] commands
+      #
+      # @return [String]
+      #
+      # @api public
+      def self.available(*commands)
+        commands = commands.empty? ? executables : commands
+        commands.compact.uniq.find { |cmd| command_exists?(cmd) }
+      end
+
+      # Check if command is available
+      #
+      # @example Basic usage
+      #   available?  # => true
+      #
+      # @example Usage with command
+      #   available?('less') # => true
+      #
+      # @return [Boolean]
+      #
+      # @api public
+      def self.available?(*commands)
+        !available(*commands).nil?
+      end
+
+      # Use system command to page output text
+      #
+      # @example
+      #  page('some long text...')
+      #
+      # @param [String] text
+      #   the text to paginate
+      #
+      # @return [nil]
+      #
+      # @api public
+      def page(text, &callback)
+        read_io, write_io = IO.pipe
+
+        if Kernel.fork
+          # parent process
+          write_io.close
+          input.reopen(read_io)
+          read_io.close
+
+          # Wait until we have input before we start the pager
+          IO.select [input]
+
+          begin
+            exec(pager_command)
+          rescue SystemCallError
+            exit 1
+          end
+        else
+          # child process
+          read_io.close
+          write_io.write(text)
+          write_io.close
+        end
+      end
+
+      private
+
+      # List possible executables for output paging
+      #
+      # @return [Array[String]]
+      #
+      # @api private
+      def self.executables
+        [ENV['GIT_PAGER'], ENV['PAGER'],
+         `git config --get-all core.pager`.split.first,
+        'less', 'more', 'cat', 'pager']
+      end
+      private_class_method :executables
+
+      # Check if command exists
+      #
+      # @example
+      #   command_exists?('less) # => true
+      #
+      # @param [String] command
+      #   the command to check
+      #
+      # @return [Boolean]
+      #
+      # @api private
+      def self.command_exists?(command)
+        !TTY::Which.which(command).nil?
+      end
+      private_class_method :command_exists?
+
+      # The pager command to run
+      #
+      # @return [String]
+      #   the name of executable to run
+      #
+      # @api private
+      def pager_command(*commands)
+        @pager_command = if @pager_command && commands.empty?
+          @pager_command
+        else
+          self.class.available(*commands)
+        end
+      end
+    end # SystemPager
+  end # Pager
+end # TTY

data/lib/tty/pager/version.rb

@@ -0,0 +1,7 @@
+# coding: utf-8
+
+module TTY
+  class Pager
+    VERSION = "0.1.0"
+  end # Pager
+end # TTY

data/lib/tty/pager.rb

@@ -0,0 +1,129 @@
+# coding: utf-8
+
+require "tty/pager/basic"
+require "tty/pager/null"
+require "tty/pager/system"
+require "tty/pager/version"
+
+module TTY
+  class Pager
+    PROMPT_HEIGHT = 2
+
+    PAGE_BREAK = "\n--- Page -%s- " \
+                  "Press enter/return to continue " \
+                  "(or q to quit) ---".freeze
+
+    # Create a pager
+    #
+    # @param [Hash] options
+    # @option options [Proc] :prompt
+    #   a proc object that accepts page number
+    # @option options [IO] :input
+    #   the object to send input to
+    # @option options [IO] :output
+    #   the object to send output to
+    # @option options [Integer] :height
+    #   the terminal height
+    # @option options [Integer] :width
+    #   the terminal width
+    # @option options [Boolean] :enabled
+    #   disable/enable text paging
+    #
+    # @api public
+    def initialize(options = {})
+      @height  = options.fetch(:height) { page_height }
+      @width   = options.fetch(:width)  { page_width }
+      @input   = options.fetch(:input)  { $stdin }
+      @output  = options.fetch(:output) { $stdout }
+      @enabled = options.fetch(:enabled) { true }
+      @prompt  = options.fetch(:prompt) { default_prompt }
+      @height -= PROMPT_HEIGHT
+      @output = output
+
+      if self.class == TTY::Pager
+        @pager = find_available
+      end
+    end
+
+    # Default prompt for paging
+    #
+    # @return [Proc]
+    #
+    # @api private
+    def default_prompt
+      proc { |page_num| output.puts PAGE_BREAK % page_num }
+    end
+
+    # Check if pager is enabled
+    #
+    # @return [Boolean]
+    #
+    # @api public
+    def enabled?
+      !!@enabled
+    end
+
+    # Page the given text through the available pager
+    #
+    # @param [String] text
+    #   the text to run through a pager
+    #
+    # @yield [Integer] page number
+    #
+    # @return [TTY::Pager]
+    #
+    # @api public
+    def page(text, &callback)
+      pager.page(text, &callback)
+      self
+    end
+
+    # The terminal height
+    #
+    # @api public
+    def page_height
+      TTY::Screen.height
+    end
+
+    # The terminal width
+    #
+    # @api public
+    def page_width
+      TTY::Screen.width
+    end
+
+    protected
+
+    attr_reader :output
+
+    attr_reader :input
+
+    attr_reader :pager
+
+    # Find available pager
+    #
+    # If the user disabled paging then a NullPager is returned,
+    # otherwise a check is performed to find native system
+    # utility to perform pagination with SystemPager. Finally,
+    # if no system utility exists a BasicPager is used which
+    # is pure Ruby implementation.
+    #
+    # @api private
+    def find_available
+      if !enabled?
+        NullPager.new
+      elsif SystemPager.available? && !Pager.jruby?
+        SystemPager.new
+      else
+        BasicPager.new
+      end
+    end
+
+    # Check if running on jruby
+    #
+    # @api private
+    def self.jruby?
+      RbConfig::CONFIG['ruby_install_name'] == 'jruby'
+    end
+  end # Pager
+end # TTY

data/lib/tty-pager.rb

@@ -0,0 +1,6 @@
+# coding: utf-8
+
+require 'tty-screen'
+require 'tty-which'
+require 'verse'
+require 'tty/pager'

data/spec/spec_helper.rb

@@ -0,0 +1,45 @@
+# coding: utf-8
+
+if RUBY_VERSION > '1.9' and (ENV['COVERAGE'] || ENV['TRAVIS'])
+  require 'simplecov'
+  require 'coveralls'
+
+  SimpleCov.formatter = SimpleCov::Formatter::MultiFormatter[
+    SimpleCov::Formatter::HTMLFormatter,
+    Coveralls::SimpleCov::Formatter
+  ]
+
+  SimpleCov.start do
+    command_name 'spec'
+    add_filter 'spec'
+  end
+end
+
+require 'tty-pager'
+
+RSpec.configure do |config|
+  config.expect_with :rspec do |expectations|
+    expectations.include_chain_clauses_in_custom_matcher_descriptions = true
+  end
+
+  config.mock_with :rspec do |mocks|
+    mocks.verify_partial_doubles = true
+  end
+
+  # Limits the available syntax to the non-monkey patched syntax that is recommended.
+  config.disable_monkey_patching!
+
+  # This setting enables warnings. It's recommended, but in some cases may
+  # be too noisy due to issues in dependencies.
+  config.warnings = true
+
+  if config.files_to_run.one?
+    config.default_formatter = 'doc'
+  end
+
+  config.profile_examples = 2
+
+  config.order = :random
+
+  Kernel.srand config.seed
+end

data/spec/unit/basic/page_spec.rb

@@ -0,0 +1,135 @@
+# coding: utf-8
+
+RSpec.describe TTY::Pager::BasicPager, '.page' do
+  let(:input)  { StringIO.new }
+  let(:output) { StringIO.new }
+
+  it "doesn't paginate empty string" do
+    pager = described_class.new(output: output, input: input)
+    pager.page("")
+    expect(output.string).to eq("")
+  end
+
+  it "doesn't paginate text that fits on screen" do
+    text = "I try all things, I achieve what I can.\n"
+    pager = described_class.new(output: output, width: 100, height: 10)
+    pager.page(text)
+    expect(output.string).to eq(text)
+  end
+
+  it "breaks text exceeding terminal width" do
+    text = ""
+    text << "It is not down on any map; true places never are.\n"
+    input << "\n"
+    input.rewind
+    pager = described_class.new(output: output, input: input,
+                                width: 10, height: 6)
+    pager.page(text)
+    expect(output.string).to eq([
+      "It is not ",
+      "down on ",
+      "any map; ",
+      "true ",
+      "",
+      "--- Page -1- Press enter/return to continue (or q to quit) ---",
+      "places ",
+      "never are.\n"
+    ].join("\n"))
+  end
+
+  it "continues paging when enter is pressed" do
+    text = ""
+    10.times { text << "I try all things, I achieve what I can.\n"}
+    input << "\n\n\n"
+    input.rewind
+    pager = described_class.new(output: output, input: input,
+                                width: 100, height: 5)
+    pager.page(text)
+    expect(output.string).to eq([
+      "I try all things, I achieve what I can.",
+      "I try all things, I achieve what I can.",
+      "I try all things, I achieve what I can.",
+      "",
+      "--- Page -1- Press enter/return to continue (or q to quit) ---",
+      "I try all things, I achieve what I can.",
+      "I try all things, I achieve what I can.",
+      "I try all things, I achieve what I can.",
+      "",
+      "--- Page -2- Press enter/return to continue (or q to quit) ---",
+      "I try all things, I achieve what I can.",
+      "I try all things, I achieve what I can.",
+      "I try all things, I achieve what I can.",
+      "",
+      "--- Page -3- Press enter/return to continue (or q to quit) ---",
+      "I try all things, I achieve what I can.\n"
+    ].join("\n"))
+  end
+
+  it "stops paging when q is pressed" do
+    text = ""
+    10.times { text << "I try all things, I achieve what I can.\n"}
+    input << "\nq\n"
+    input.rewind
+    pager = described_class.new(output: output, input: input,
+                                width: 100, height: 5)
+    pager.page(text)
+    expect(output.string).to eq([
+      "I try all things, I achieve what I can.",
+      "I try all things, I achieve what I can.",
+      "I try all things, I achieve what I can.",
+      "",
+      "--- Page -1- Press enter/return to continue (or q to quit) ---",
+      "I try all things, I achieve what I can.",
+      "I try all things, I achieve what I can.",
+      "I try all things, I achieve what I can.",
+      "",
+      "--- Page -2- Press enter/return to continue (or q to quit) ---\n",
+    ].join("\n"))
+  end
+
+  it "allows to change paging prompt" do
+    text = ""
+    5.times { text << "I try all things, I achieve what I can.\n"}
+    input << "\nq\n"
+    input.rewind
+    prompt = proc { |num| output.puts "Page -#{num}-" }
+    pager = described_class.new(output: output, input: input,
+                                width: 100, height: 5, prompt: prompt)
+    pager.page(text)
+    expect(output.string).to eq([
+      "I try all things, I achieve what I can.",
+      "I try all things, I achieve what I can.",
+      "I try all things, I achieve what I can.",
+      "Page -1-",
+      "I try all things, I achieve what I can.",
+      "I try all things, I achieve what I can.\n",
+    ].join("\n"))
+  end
+
+  it "preserves new lines when breaking" do
+    text = "a\na\na\na\na\na\na\na\na\na"
+    input << "\n\n\n"
+    input.rewind
+    pager = described_class.new(output: output, input: input,
+                                width: 1, height: 5)
+    pager.page(text)
+    expect(output.string).to eq([
+      "a",
+      "a",
+      "a",
+      "",
+      "--- Page -1- Press enter/return to continue (or q to quit) ---",
+      "a",
+      "a",
+      "a",
+      "",
+      "--- Page -2- Press enter/return to continue (or q to quit) ---",
+      "a",
+      "a",
+      "a",
+      "",
+      "--- Page -3- Press enter/return to continue (or q to quit) ---",
+      "a"
+    ].join("\n"))
+  end
+end

data/spec/unit/null/page_spec.rb

@@ -0,0 +1,12 @@
+# coding: utf-8
+
+RSpec.describe TTY::Pager::NullPager, '.page' do
+  let(:output)   { StringIO.new }
+
+  it "doesn't paginate empty string" do
+    pager = described_class.new(output: output)
+    text = "I try all things, I achieve what I can.\n"
+    pager.page(text)
+    expect(output.string).to eq(text)
+  end
+end

data/spec/unit/page_spec.rb

@@ -0,0 +1,41 @@
+# coding: utf-8
+
+RSpec.describe TTY::Pager, '.page' do
+  let(:output) { StringIO.new }
+
+  it "selects null pager when disabled" do
+    null_pager = spy(:null_pager)
+    allow(TTY::Pager::NullPager).to receive(:new) { null_pager }
+
+    pager = described_class.new(enabled: false)
+    text = "I try all things, I achieve what I can.\n"
+    pager.page(text)
+
+    expect(TTY::Pager::NullPager).to have_received(:new)
+  end
+
+  it "selects basic pager on non tty systems" do
+    basic_pager = spy(:basic_pager)
+    allow(TTY::Pager::SystemPager).to receive(:available?) { false }
+    allow(TTY::Pager::BasicPager).to receive(:new) { basic_pager }
+
+    pager = described_class.new
+    text = "I try all things, I achieve what I can.\n"
+    pager.page(text)
+
+    expect(basic_pager).to have_received(:page).with(text)
+  end
+
+  it "selects system pager on systems with tty" do
+    system_pager = spy(:system_pager)
+    allow(TTY::Pager::SystemPager).to receive(:available?) { true }
+    allow(described_class).to receive(:jruby?) { false }
+    allow(TTY::Pager::SystemPager).to receive(:new) { system_pager }
+
+    pager = described_class.new
+    text = "I try all things, I achieve what I can.\n"
+    pager.page(text)
+
+    expect(system_pager).to have_received(:page).with(text)
+  end
+end

data/spec/unit/system/available_spec.rb

@@ -0,0 +1,25 @@
+# coding: utf-8
+
+RSpec.describe TTY::Pager::SystemPager, '#available' do
+  let(:execs)   { ['less', 'more'] }
+
+  subject(:pager) { described_class }
+
+  it 'finds available command' do
+    allow(pager).to receive(:executables).and_return(execs)
+    allow(pager).to receive(:command_exists?).with('less') { true }
+    allow(pager).to receive(:command_exists?).with('more') { false }
+    expect(pager.available).to eql('less')
+  end
+
+  it "doesn't find command" do
+    allow(pager).to receive(:executables).and_return(execs)
+    allow(pager).to receive(:command_exists?) { false }
+    expect(pager.available).to be_nil
+  end
+
+  it "takes precedence over other commands" do
+    allow(pager).to receive(:command_exists?).with('more') { true }
+    expect(pager.available('more')).to eql('more')
+  end
+end

data/spec/unit/system/page_spec.rb

@@ -0,0 +1,23 @@
+# coding: utf-8
+
+RSpec.describe TTY::Pager::SystemPager, '.page' do
+  let(:input)    { StringIO.new }
+  let(:output)   { StringIO.new }
+
+  it "executes the pager command in a subprocess" do
+    text = "I try all things, I achieve what I can.\n"
+    pager = described_class.new(output: output, input: input)
+
+    allow(pager).to receive(:exec)
+    allow(Kernel).to receive(:fork).and_return(true)
+    allow(pager).to receive(:pager_command).and_return('less')
+    allow(IO).to receive(:select)
+    allow(input).to receive(:reopen)
+
+    pager.page(text)
+
+    expect(IO).to have_received(:select).with([input])
+    expect(pager).to have_received(:exec).with('less')
+    expect(output.read).to eq('')
+  end
+end

data/tasks/console.rake

@@ -0,0 +1,10 @@
+# encoding: utf-8
+
+desc 'Load gem inside irb console'
+task :console do
+  require 'irb'
+  require 'irb/completion'
+  require File.join(__FILE__, '../../lib/tty-pager')
+  ARGV.clear
+  IRB.start
+end

data/tasks/coverage.rake

@@ -0,0 +1,11 @@
+# encoding: utf-8
+
+desc 'Measure code coverage'
+task :coverage do
+  begin
+    original, ENV['COVERAGE'] = ENV['COVERAGE'], 'true'
+    Rake::Task['spec'].invoke
+  ensure
+    ENV['COVERAGE'] = original
+  end
+end

data/tasks/spec.rake

@@ -0,0 +1,29 @@
+# encoding: utf-8
+
+begin
+  require 'rspec/core/rake_task'
+
+  desc 'Run all specs'
+  RSpec::Core::RakeTask.new(:spec) do |task|
+    task.pattern = 'spec/{unit,integration}{,/*/**}/*_spec.rb'
+  end
+
+  namespace :spec do
+    desc 'Run unit specs'
+    RSpec::Core::RakeTask.new(:unit) do |task|
+      task.pattern = 'spec/unit{,/*/**}/*_spec.rb'
+    end
+
+    desc 'Run integration specs'
+    RSpec::Core::RakeTask.new(:integration) do |task|
+      task.pattern = 'spec/integration{,/*/**}/*_spec.rb'
+    end
+  end
+
+rescue LoadError
+  %w[spec spec:unit spec:integration].each do |name|
+    task name do
+      $stderr.puts "In order to run #{name}, do `gem install rspec`"
+    end
+  end
+end

data/tty-pager.gemspec

@@ -0,0 +1,26 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'tty/pager/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "tty-pager"
+  spec.version       = TTY::Pager::VERSION
+  spec.authors       = ["Piotr Murach"]
+  spec.email         = [""]
+  spec.summary       = %q{Terminal output paging in a cross-platform way supporting all major ruby interpreters.}
+  spec.description   = %q{Terminal output paging in a cross-platform way supporting all major ruby interpreters.}
+  spec.homepage      = "https://github.com/peter-murach/tty-pager"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency 'tty-screen', '~> 0.2.0'
+  spec.add_dependency 'tty-which',  '~> 0.1.0'
+  spec.add_dependency 'verse',      '~> 0.4.0'
+
+  spec.add_development_dependency 'bundler', '~> 1.6'
+end

metadata

@@ -0,0 +1,133 @@
+--- !ruby/object:Gem::Specification
+name: tty-pager
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Piotr Murach
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-05-31 00:00:00.000000000 Z
+dependencies:
+- !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-which
+  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: verse
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.4.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.4.0
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.6'
+description: Terminal output paging in a cross-platform way supporting all major ruby
+  interpreters.
+email:
+- ''
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- .ruby-version
+- .travis.yml
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/tty-pager.rb
+- lib/tty/pager.rb
+- lib/tty/pager/basic.rb
+- lib/tty/pager/null.rb
+- lib/tty/pager/system.rb
+- lib/tty/pager/version.rb
+- spec/spec_helper.rb
+- spec/unit/basic/page_spec.rb
+- spec/unit/null/page_spec.rb
+- spec/unit/page_spec.rb
+- spec/unit/system/available_spec.rb
+- spec/unit/system/page_spec.rb
+- tasks/console.rake
+- tasks/coverage.rake
+- tasks/spec.rake
+- tty-pager.gemspec
+homepage: https://github.com/peter-murach/tty-pager
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.3
+signing_key: 
+specification_version: 4
+summary: Terminal output paging in a cross-platform way supporting all major ruby
+  interpreters.
+test_files:
+- spec/spec_helper.rb
+- spec/unit/basic/page_spec.rb
+- spec/unit/null/page_spec.rb
+- spec/unit/page_spec.rb
+- spec/unit/system/available_spec.rb
+- spec/unit/system/page_spec.rb
+has_rdoc: