tty-cursor 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 1a327e575afda2187a43bf90385fae901872320f
-  data.tar.gz: bb8ad05a2a7740c63fb0532cd96f295b040f2258
+  metadata.gz: 21bae31e727bfc59faaf59b29fe458f9d6c96463
+  data.tar.gz: 145f6e5308fc50a95c51e76bff5b076114d6bc06
 SHA512:
-  metadata.gz: b9190c8bfe4ccb4987a3880492a6c939e1ca2e2668e3d2d578212dc2fc083bb6c53254dc330baa78d856e16035d2a532a40066e2608ed035551be9e6681bc31e
-  data.tar.gz: ea66792a3c695eeded5733cac0968ad1f8b85ba0687b02c4e46e64fb25ca50e4ff373caa34c5fcefdef069322a8184adbee7438b24888bfe402f8dc297b85333
+  metadata.gz: 38785d325d0a77807bfdc213b87e90e6786a1508c4416a8ecf68bf92d1227e9cdb35aa7fcc43116e1e49759dc07e10bddcd321eb1f5fc4e70d89a5e6cbeca0fd
+  data.tar.gz: 12c6e6be868e68e6f0f3bd50b02eea8c409940ed9189d3d99910eeab43c6c4ccd3c85e4d0bd789e04a8b66262e58fe79dfc9198e7abc449c4df500d66231b662

data/.travis.yml

@@ -6,22 +6,21 @@ bundler_args: --without yard benchmarks
 script: "bundle exec rake ci"
 rvm:
   - 1.9.3
-  - 2.0
-  - 2.1
-  - 2.2
-  - 2.3.0
+  - 2.0.0
+  - 2.1.10
+  - 2.2.6
+  - 2.3.3
+  - 2.4.0
   - ruby-head
+  - jruby-9000
+  - jruby-head
+  - rbx-3
 matrix:
-  include:
-    - rvm: jruby-19mode
-    - rvm: jruby-20mode
-    - rvm: jruby-21mode
-    - rvm: jruby-9000
-    - rvm: jruby-head
-    - rvm: rbx-2
   allow_failures:
+    - rvm: 2.4.0
     - rvm: ruby-head
     - rvm: jruby-head
+    - rvm: rbx-3
   fast_finish: true
 branches:
   only: master

data/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Change log
 
+## [v0.4.0] - 2017-01-08
+
+### Added
+* Add #clear_char for erasing characters
+* Add #clear_line_before for erasing line before the cursor
+* Add #clear_line_after for erasing line after the cursor
+* Add #column to move the cursor horizontally in the current line
+* Add #row to move the cursor vertically in the current column
+
+### Changed
+* Remove #move_start
+* Change #next_line to move the cursor to beginning of the line
+* Change #clear_line to move the cursor to beginning of the line
+* Change alias_method to alias
+
+### Fixed
+* Fix #clear_line to correctly clear whole line
+
 ## [v0.3.0] - 2016-05-21
 
 ### Fixed
@@ -14,6 +32,7 @@
 
 * Initial implementation and release
 
+[v0.4.0]: https://github.com/peter-murach/tty-cursor/compare/v0.3.0...v0.4.0
 [v0.3.0]: https://github.com/peter-murach/tty-cursor/compare/v0.2.0...v0.3.0
 [v0.2.0]: https://github.com/peter-murach/tty-cursor/compare/v0.1.0...v0.2.0
 [v0.1.0]: https://github.com/peter-murach/tty-cursor/compare/v0.1.0

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,49 @@
+# Contributor Code of Conduct
+
+As contributors and maintainers of this project, and in the interest of
+fostering an open and welcoming community, we pledge to respect all people who
+contribute through reporting issues, posting feature requests, updating
+documentation, submitting pull requests or patches, and other activities.
+
+We are committed to making participation in this project a harassment-free
+experience for everyone, regardless of level of experience, gender, gender
+identity and expression, sexual orientation, disability, personal appearance,
+body size, race, ethnicity, age, religion, or nationality.
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery
+* Personal attacks
+* Trolling or insulting/derogatory comments
+* Public or private harassment
+* Publishing other's private information, such as physical or electronic
+  addresses, without explicit permission
+* Other unethical or unprofessional conduct
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+By adopting this Code of Conduct, project maintainers commit themselves to
+fairly and consistently applying these principles to every aspect of managing
+this project. Project maintainers who do not follow or enforce the Code of
+Conduct may be permanently removed from the project team.
+
+This code of conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community.
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting a project maintainer at [email]. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. Maintainers are
+obligated to maintain confidentiality with regard to the reporter of an
+incident.
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 1.3.0, available at
+[http://contributor-covenant.org/version/1/3/0/][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/3/0/

data/Gemfile

@@ -4,7 +4,7 @@ gemspec
 
 group :development do
   gem 'rake',  '~> 10.4.2'
-  gem 'rspec', '~> 3.4.0'
+  gem 'rspec', '~> 3.5.0'
   gem 'yard',  '~> 0.8.7'
   gem 'benchmark-ips', '~> 2.0.0'
 end
@@ -13,4 +13,5 @@ group :metrics do
   gem 'coveralls', '~> 0.8.9'
   gem 'simplecov', '~> 0.10.0'
   gem 'yardstick', '~> 0.9.9'
+  gem 'term-ansicolor', '=1.3.2'
 end

data/README.md

@@ -1,6 +1,7 @@
 # TTY::Cursor [![Gitter](https://badges.gitter.im/Join%20Chat.svg)][gitter]
 [![Gem Version](https://badge.fury.io/rb/tty-cursor.svg)][gem]
 [![Build Status](https://secure.travis-ci.org/piotrmurach/tty-cursor.svg?branch=master)][travis]
+[![Build status](https://ci.appveyor.com/api/projects/status/4k7cd69jscwg7fl7?svg=true)][appveyor]
 [![Code Climate](https://codeclimate.com/github/piotrmurach/tty-cursor/badges/gpa.svg)][codeclimate]
 [![Coverage Status](https://coveralls.io/repos/piotrmurach/tty-cursor/badge.svg)][coverage]
 [![Inline docs](http://inch-ci.org/github/piotrmurach/tty-cursor.svg?branch=master)][inchpages]
@@ -8,13 +9,14 @@
 [gitter]: https://gitter.im/piotrmurach/tty
 [gem]: http://badge.fury.io/rb/tty-cursor
 [travis]: http://travis-ci.org/piotrmurach/tty-cursor
+[appveyor]: https://ci.appveyor.com/project/piotrmurach/tty-cursor
 [codeclimate]: https://codeclimate.com/github/piotrmurach/tty-cursor
 [coverage]: https://coveralls.io/r/piotrmurach/tty-cursor
 [inchpages]: http://inch-ci.org/github/piotrmurach/tty-cursor
 
-> Terminal cursor movement and manipulation of cursor properties such as visibility.
+> Terminal cursor positioning, visibility and text manipulation.
 
-The purpose of this library is to help move terminal cursor around using intuitive commands and help in clearing terminal screen.
+The purpose of this library is to help move the terminal cursor around and manipulate text by using intuitive method calls.
 
 **TTY::Cursor** provides independent cursor movement component for [TTY](https://github.com/piotrmurach/tty) toolkit.
 
@@ -38,27 +40,33 @@ Or install it yourself as:
 
 * [1. Usage](#1-usage)
 * [2. Interface](#2-interface)
-  * [2.1 Cursor control](#21-cursor-control)
+  * [2.1 Cursor Positioning](#21-cursor-positioning)
     * [2.1.1 move_to(x, y)](#211-move_tox-y)
     * [2.1.2 move(x, y)](#212-movex-y)
-    * [2.1.3 up(count)](#213-upcount)
-    * [2.1.4 down(count)](#214-downcount)
-    * [2.1.5 forward(count)](#215-forwardcount)
-    * [2.1.6 backward(count)](#216-backwardcount)
-    * [2.1.7 save](#217-save)
-    * [2.1.8 restore](#218-restore)
-    * [2.1.9 current](#219-current)
-    * [2.1.10 next_line](#2110-next_line)
-    * [2.1.11 prev_line](#2111-prev_line)
-    * [2.1.12 show](#2112-show)
-    * [2.1.13 hide](#2113-hide)
-    * [2.1.14 invisible(stream)](#2114-invisiblestream)
-  * [2.2 Clearing text](#22-clearing-text)
-    * [2.2.1 clear_line](#221-clear_line)
-    * [2.2.2 clear_lines(count, direction)](#222-clear_linescount-direction)
-    * [2.2.3 clear_screen_down](#223-clear_screen_down)
-    * [2.2.4 clear_screen_up](#224-clear_screen_up)
-    * [2.2.5 clear_screen](#225-clear_screen)
+    * [2.1.3 up(n)](#213-upn)
+    * [2.1.4 down(n)](#214-downn)
+    * [2.1.5 forward(n)](#215-forwardn)
+    * [2.1.6 backward(n)](#216-backwardn)
+    * [2.1.7 column(n)](#217-columnn)
+    * [2.1.8 row(n)](#218-rown)
+    * [2.1.9 next_line](#219-next_line)
+    * [2.1.10 prev_line](#2110-prev_line)
+    * [2.1.11 save](#2111-save)
+    * [2.1.12 restore](#2112-restore)
+    * [2.1.13 current](#2113-current)
+  * [2.2 Cursor Visibility](#22-cursor-visibility)
+    * [2.2.1 show](#221-show)
+    * [2.2.2 hide](#222-hide)
+    * [2.2.3 invisible(stream)](#2114-invisiblestream)
+  * [2.3 Text Modification](#23-text-modification)
+    * [2.3.1 clear_char(n)](#231-clear_charn)
+    * [2.3.2 clear_line](#232-clear_line)
+    * [2.3.3 clear_line_before](#233-clear_line)
+    * [2.3.4 clear_line_after](#234-clear_line)
+    * [2.3.5 clear_lines(n, direction)](#235-clear_linesn-direction)
+    * [2.3.6 clear_screen_down](#236-clear_screen_down)
+    * [2.3.7 clear_screen_up](#237-clear_screen_up)
+    * [2.3.8 clear_screen](#238-clear_screen)
 
 ## 1. Usage
 
@@ -68,21 +76,31 @@ Or install it yourself as:
 cursor = TTY::Cursor
 ```
 
-and then to move cursor 5 rows up and 2 columns forward do:
+and to move the cursor current position by 5 rows up and 2 columns right do:
 
 ```ruby
 print cursor.up(5) + cursor.forward(2)
 ```
 
-or simple call `move` to move cursor relative to current position:
+or call `move` to move cursor relative to current position:
 
 ```ruby
 print cursor.move(5, 2)
 ```
 
+to remove text from the current line do:
+
+```ruby
+print cursor.clear_line
+```
+
 ## 2. Interface
 
-### 2.1 Cursor control
+### 2.1 Cursor Positioning
+
+All methods in this section allow to position the cursor around the terminal viewport.
+
+Cursor movement will be bounded by the current viewport into the buffer. Scrolling (if available) will not occur.
 
 #### 2.1.1 move_to(x, y)
 
@@ -98,53 +116,65 @@ cursor.move_to
 
 Move cursor by x columns and y rows relative to its current position.
 
-#### 2.1.3 up(count)
+#### 2.1.3 up(n)
+
+Move the cursor up by `n` rows; the default n is `1`.
+
+#### 2.1.4 down(n)
 
-Move the cursor up by `count` rows; the default count is `1`.
+Move the cursor down by `n` rows; the default n is `1`.
 
-#### 2.1.4 down(count)
+#### 2.1.5 forward(n)
 
-Move the cursor down by `count` rows; the default count is `1`.
+Move the cursor forward by `n` columns; the default n is `1`.
 
-#### 2.1.5 forward(count)
+#### 2.1.6 backward(n)
 
-Move the cursor forward by `count` columns; the default count is `1`.
+Move the cursor backward by `n` columns; the default n is `1`.
 
-#### 2.1.6 backward(count)
+#### 2.1.7 column(n)
 
-Move the cursor backward by COUNT columns; the default count is `1`.
+Cursor moves to `<n>`th position horizontally in the current line.
 
-#### 2.1.7 save
+#### 2.1.8 row(n)
+
+Cursor moves the the `<n>`th position vertically in the current column.
+
+#### 2.1.9 next_line
+
+Move the cursor down to the beginning of the next line.
+
+#### 2.1.10 prev_line
+
+Move the cursor up to the beginning of the previous line.
+
+#### 2.1.11 save
 
 Save current cursor position.
 
-#### 2.1.8 restore
+#### 2.1.12 restore
 
 Restore cursor position after a save cursor was called.
 
-#### 2.1.9 current
+#### 2.1.13 current
 
 Query current cursor position
 
-#### 2.1.10 next_line
-
-Move the cursor to the next line.
+### 2.2 Cursor Visibility
 
-#### 2.1.11 prev_line
+The following methods control the visibility of the cursor.
 
-Move the cursor to the previous line.
+#### 2.2.1 show
 
-#### 2.1.12 show
+Show the cursor.
 
-Show cursor
+#### 2.2.2 hide
 
-#### 2.1.13 hide
+Hide the cursor.
 
-Hide cursor
+#### 2.2.3 invisible(stream)
 
-#### 2.1.14 invisible(stream)
-
-To hide cursor for the duration of the block do:
+To hide the cursor for the duration of the block do:
 
 ```ruby
 cursor.invisible { ... }
@@ -156,31 +186,45 @@ By default standard output will be used but you can change that by passing a dif
 cursor.invisible($stderr) { .... }
 ```
 
-### 2.2 Clearing text
+### 2.3 Text Modification
+
+All methods in this section provide APIs to modify text buffer contents.
+
+#### 2.3.1 clear_char(n)
+
+Erase `<n>` characters from the current cursor position by overwritting them with space character.
+
+#### 2.3.2 clear_line
+
+Erase the entire current line and return cursor to beginning of the line.
+
+#### 2.3.3 clear_line_before
+
+Erase from the beginning of the line up to and including the current position.
 
-#### 2.2.1 clear_line
+#### 2.3.4 clear_line_after
 
-Erase the entire current line.
+Erase from the current position (inclusive) to the end of the line/display.
 
-#### 2.2.2 clear_lines(count, direction)
+#### 2.3.5 clear_lines(n, direction)
 
-Erase `count` rows in given direction; the default direction is `:up`.
+Erase `n` rows in given direction; the default direction is `:up`.
 
 ```ruby
 cursor.clear_lines(5, :down)
 ```
 
-#### 2.2.3 clear_screen_down
+#### 2.3.6 clear_screen
 
-Erase the screen from the current line down to the bottom of the screen.
+Erase the screen with the background colour and moves the cursor to home.
 
-#### 2.2.4 clear_screen_up
+#### 2.3.7 clear_screen_down
 
-Erase the screen from the current line up to the top of the screen.
+Erase the screen from the current line down to the bottom of the screen.
 
-#### 2.2.5 clear_screen
+#### 2.3.8 clear_screen_up
 
-Erase the screen with the background colour and moves the cursor to home.
+Erase the screen from the current line up to the top of the screen.
 
 ## Contributing
 
@@ -190,6 +234,8 @@ Erase the screen with the background colour and moves the cursor to home.
 4. Push to the branch (`git push origin my-new-feature`)
 5. Create a new Pull Request
 
+This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+
 ## Copyright
 
-Copyright (c) 2015-2016 Piotr Murach. See LICENSE for further details.
+Copyright (c) 2015-2017 Piotr Murach. See LICENSE for further details.

data/appveyor.yml

@@ -0,0 +1,23 @@
+---
+install:
+  - SET PATH=C:\Ruby%ruby_version%\bin;%PATH%
+  - ruby --version
+  - gem --version
+  - bundle install
+build: off
+test_script:
+  - bundle exec rake ci
+environment:
+  matrix:
+    - ruby_version: "193"
+    - ruby_version: "200"
+    - ruby_version: "200-x64"
+    - ruby_version: "21"
+    - ruby_version: "21-x64"
+    - ruby_version: "22"
+    - ruby_version: "22-x64"
+    - ruby_version: "23"
+    - ruby_version: "23-x64"
+matrix:
+  allow_failures:
+    - ruby_version: "193"

data/lib/tty/cursor.rb

@@ -5,22 +5,22 @@ module TTY
   module Cursor
     module_function
 
-    ECMA_CSI = "\e[".freeze
+    ESC = "\e".freeze
+    CSI = "\e[".freeze
     DEC_RST  = 'l'.freeze
     DEC_SET  = 'h'.freeze
     DEC_TCEM = '?25'.freeze
-    ECMA_CLR = 'K'.freeze
 
     # Make cursor visible
     # @api public
     def show
-      ECMA_CSI + DEC_TCEM + DEC_SET
+      CSI + DEC_TCEM + DEC_SET
     end
 
     # Hide cursor
     # @api public
     def hide
-      ECMA_CSI + DEC_TCEM + DEC_RST
+      CSI + DEC_TCEM + DEC_RST
     end
 
     # Switch off cursor for the block
@@ -35,19 +35,19 @@ module TTY
     # Save current position
     # @api public
     def save
-      ECMA_CSI + 's'
+      CSI + 's'
     end
 
     # Restore cursor position
     # @api public
     def restore
-      ECMA_CSI + 'u'
+      CSI + 'u'
     end
 
     # Query cursor current position
     # @api public
     def current
-      ECMA_CSI + '6n'
+      CSI + '6n'
     end
 
     # Set the cursor absolute position
@@ -55,8 +55,8 @@ module TTY
     # @param [Integer] column
     # @api public
     def move_to(row = nil, column = nil)
-      return ECMA_CSI + 'H' if row.nil? && column.nil?
-      ECMA_CSI + "#{column + 1};#{row + 1}H"
+      return CSI + 'H' if row.nil? && column.nil?
+      CSI + "#{column + 1};#{row + 1}H"
     end
 
     # Move cursor relative to its current position
@@ -70,95 +70,124 @@ module TTY
       (y < 0 ? down(-y) : (y > 0 ? up(y) : ''))
     end
 
-    # Move cursor up by number of lines
-    #
-    # @param [Integer] count
-    #
+    # Move cursor up by n
+    # @param [Integer] n
     # @api public
-    def up(count = nil)
-      ECMA_CSI + "#{(count || 1)}A"
+    def up(n = nil)
+      CSI + "#{(n || 1)}A"
     end
-    alias_method :cursor_up, :up
+    alias cursor_up up
 
-    # Move cursor down by number of lines
-    #
-    # @param [Integer] count
-    #
+    # Move the cursor down by n
+    # @param [Integer] n
     # @api public
-    def down(count = nil)
-      ECMA_CSI + "#{(count || 1)}B"
+    def down(n = nil)
+      CSI + "#{(n || 1)}B"
     end
-    alias_method :cursor_down, :down
+    alias cursor_down down
 
-    # Move to start of the line
-    #
+    # Move the cursor backward by n
+    # @param [Integer] n
     # @api public
-    def move_start
-      backward(1000)
+    def backward(n = nil)
+      CSI + "#{n || 1}D"
     end
+    alias cursor_backward backward
 
-    # @param [Integer] count
-    #   how far to go left
+    # Move the cursor forward by n
+    # @param [Integer] n
     # @api public
-    def backward(count = nil)
-      ECMA_CSI + "#{count || 1}D"
+    def forward(n = nil)
+      CSI + "#{n || 1}C"
     end
-    alias_method :cursor_backward, :backward
+    alias cursor_forward forward
 
+    # Cursor moves to nth position horizontally in the current line
+    # @param [Integer] n
+    #   the nth aboslute position in line
     # @api public
-    def forward(count = nil)
-      ECMA_CSI + "#{count || 1}C"
+    def column(n = nil)
+      CSI + "#{n || 1}G"
     end
-    alias_method :cursor_forward, :forward
 
+    # Cursor moves to the nth position vertically in the current column
+    # @param [Integer] n
+    #   the nth absolute position in column
+    # @api public
+    def row(n = nil)
+      CSI + "#{n || 1}d"
+    end
+
+    # Move cursor down to beginning of next line
     # @api public
     def next_line
-      ECMA_CSI + 'E'
+      CSI + 'E' + column(1)
     end
 
+    # Move cursor up to beginning of previous line
     # @api public
     def prev_line
-      ECMA_CSI + 'A' + ECMA_CSI + '1G'
+      CSI + 'A' + column(1)
     end
 
-    # Clear current line
+    # Erase n characters from the current cursor position
+    # @api public
+    def clear_char(n = nil)
+      CSI + "#{n}X"
+    end
+
+    # Erase the entire current line and return to beginning of the line
     # @api public
     def clear_line
-      move_start + ECMA_CSI + ECMA_CLR
+      CSI + '2K' + column(1)
+    end
+
+    # Erase from the beginning of the line up to and including
+    # the current cursor position.
+    # @api public
+    def clear_line_before
+      CSI + '0K'
+    end
+
+    # Erase from the current position (inclusive) to
+    # the end of the line
+    # @api public
+    def clear_line_after
+      CSI + '1K'
     end
 
     # Clear a number of lines
     #
-    # @param [Integer] count
+    # @param [Integer] n
     #   the number of lines to clear
     # @param [Symbol] :direction
     #   the direction to clear, default :up
     #
     # @api public
-    def clear_lines(count, direction = :up)
-      count.times.reduce('') do |acc, i|
+    def clear_lines(n, direction = :up)
+      n.times.reduce('') do |acc, i|
         dir = direction == :up ? up : down
-        acc << clear_line + ((i == count - 1) ? '' : dir)
+        acc << clear_line + ((i == n - 1) ? '' : dir)
       end
     end
-    alias_method :clear_rows, :clear_lines
+    alias clear_rows clear_lines
 
     # Clear screen down from current position
     # @api public
     def clear_screen_down
-      ECMA_CSI + 'J'
+      CSI + 'J'
     end
 
     # Clear screen up from current position
     # @api public
     def clear_screen_up
-      ECMA_CSI + '1J'
+      CSI + '1J'
     end
 
     # Clear the screen with the background colour and moves the cursor to home
     # @api public
     def clear_screen
-      ECMA_CSI + '2J'
+      CSI + '2J'
     end
   end # Cursor
 end # TTY

data/lib/tty/version.rb

@@ -2,6 +2,6 @@
 
 module TTY
   module Cursor
-    VERSION = '0.3.0'
+    VERSION = '0.4.0'
   end # Cursor
 end # TTY

data/spec/unit/clear_lines_spec.rb

@@ -3,27 +3,43 @@
 RSpec.describe TTY::Cursor, '#clear_lines' do
   subject(:cursor) { described_class }
 
+  it "clears character" do
+    expect(cursor.clear_char).to eq("\e[X")
+  end
+
+  it "clears few characters" do
+    expect(cursor.clear_char(5)).to eq("\e[5X")
+  end
+
   it "clears line" do
-    expect(cursor.clear_line).to eq("\e[1000D\e[K")
+    expect(cursor.clear_line).to eq("\e[2K\e[1G")
+  end
+
+  it "clears the line before the cursor" do
+    expect(cursor.clear_line_before).to eq("\e[0K")
+  end
+
+  it "clears the line after the cursor" do
+    expect(cursor.clear_line_after).to eq("\e[1K")
   end
 
   it "clears 5 lines up" do
     expect(cursor.clear_lines(5)).to eq([
-      "\e[1000D\e[K\e[1A",
-      "\e[1000D\e[K\e[1A",
-      "\e[1000D\e[K\e[1A",
-      "\e[1000D\e[K\e[1A",
-      "\e[1000D\e[K"
+      "\e[2K\e[1G\e[1A",
+      "\e[2K\e[1G\e[1A",
+      "\e[2K\e[1G\e[1A",
+      "\e[2K\e[1G\e[1A",
+      "\e[2K\e[1G"
     ].join)
   end
 
   it "clears 5 lines down" do
     expect(cursor.clear_lines(5, :down)).to eq([
-      "\e[1000D\e[K\e[1B",
-      "\e[1000D\e[K\e[1B",
-      "\e[1000D\e[K\e[1B",
-      "\e[1000D\e[K\e[1B",
-      "\e[1000D\e[K"
+      "\e[2K\e[1G\e[1B",
+      "\e[2K\e[1G\e[1B",
+      "\e[2K\e[1G\e[1B",
+      "\e[2K\e[1G\e[1B",
+      "\e[2K\e[1G"
     ].join)
   end
 
@@ -35,7 +51,6 @@ RSpec.describe TTY::Cursor, '#clear_lines' do
     expect(cursor.clear_screen_up).to eq("\e[1J")
   end
 
-
   it "clears entire screen" do
     expect(cursor.clear_screen).to eq("\e[2J")
   end

data/spec/unit/cursor_spec.rb

@@ -39,10 +39,6 @@ RSpec.describe TTY::Cursor do
     expect(cursor.down(5)).to eq("\e[5B")
   end
 
-  it "moves to line start" do
-    expect(cursor.move_start).to eq("\e[1000D")
-  end
-
   it "moves cursorleft by 1 line default" do
     expect(cursor.backward).to eq("\e[1D")
   end
@@ -59,8 +55,24 @@ RSpec.describe TTY::Cursor do
     expect(cursor.forward(5)).to eq("\e[5C")
   end
 
+  it "moves cursor horizontal to start" do
+    expect(cursor.column).to eq("\e[1G")
+  end
+
+  it "moves cursor horizontally to 66th position" do
+    expect(cursor.column(66)).to eq("\e[66G")
+  end
+
+  it "moves cursor vertically to start" do
+    expect(cursor.row).to eq("\e[1d")
+  end
+
+  it "moves cursor vertically to 50th row" do
+    expect(cursor.row(50)).to eq("\e[50d")
+  end
+
   it "moves cursor to next line" do
-    expect(cursor.next_line).to eq("\e[E")
+    expect(cursor.next_line).to eq("\e[E\e[1G")
   end
 
   it "moves cursor to previous line" do

data/tty-cursor.gemspec

@@ -8,8 +8,8 @@ Gem::Specification.new do |spec|
   spec.version       = TTY::Cursor::VERSION
   spec.authors       = ["Piotr Murach"]
   spec.email         = [""]
-  spec.summary       = %q{Terminal cursor movement and manipulation of cursor properties such as visibility.}
-  spec.description   = %q{The purpose of this library is to help move terminal cursor around using intuitive commands and help in clearing terminal screen.}
+  spec.summary       = %q{Terminal cursor positioning, visibility and text manipulation.}
+  spec.description   = %q{The purpose of this library is to help move the terminal cursor around and manipulate text by using intuitive method calls.}
   spec.homepage       = 'http://piotrmurach.github.io/tty/'
   spec.license       = "MIT"
 

metadata

@@ -1,46 +1,47 @@
 --- !ruby/object:Gem::Specification
 name: tty-cursor
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Piotr Murach
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-05-21 00:00:00.000000000 Z
+date: 2017-01-08 00:00:00.000000000 Z
 dependencies:
 - !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: The purpose of this library is to help move terminal cursor around using
-  intuitive commands and help in clearing terminal screen.
+description: The purpose of this library is to help move the terminal cursor around
+  and manipulate text by using intuitive method calls.
 email:
 - ''
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- .gitignore
-- .rspec
-- .ruby-version
-- .travis.yml
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
 - CHANGELOG.md
+- CODE_OF_CONDUCT.md
 - Gemfile
 - LICENSE.txt
 - README.md
 - Rakefile
+- appveyor.yml
 - lib/tty-cursor.rb
 - lib/tty/cursor.rb
 - lib/tty/version.rb
@@ -63,20 +64,20 @@ 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
+rubygems_version: 2.5.1
 signing_key: 
 specification_version: 4
-summary: Terminal cursor movement and manipulation of cursor properties such as visibility.
+summary: Terminal cursor positioning, visibility and text manipulation.
 test_files:
 - spec/spec_helper.rb
 - spec/unit/clear_lines_spec.rb

data/.ruby-version

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