verse 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: c1d878680201432d1d1d982be8af68dd04f63a8e
+  data.tar.gz: 4b2a2ff0056cf352051636ab8d974afafcf7a097
+SHA512:
+  metadata.gz: 75e7dafdb2d0264ffa9457d1fae6a42159cb8a5650fa5ba87b75371fb1686ebae80c006541df13d83f7f1a753503c9749c2d64ab9f6df1760128e3ece77a8523
+  data.tar.gz: 86da8ab2fc5690ffb84795b8bf892e51b9d36289cfd054546885926946b8c819c739813dac99e9d86559e2eafbb640c22440b7ab31fa0742728a1dae47bd623f

data/.gitignore

@@ -0,0 +1,14 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log

data/.rspec

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

data/.ruby-version

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

data/.travis.yml

@@ -0,0 +1,22 @@
+language: ruby
+bundler_args: --without yard benchmarks
+script: "bundle exec rake ci"
+rvm:
+  - 1.9.3
+  - 2.0.0
+  - 2.1.0
+  - 2.2.0
+  - 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
+  fast_finish: true
+branches:
+  only: master

data/Gemfile

@@ -0,0 +1,15 @@
+source 'https://rubygems.org'
+
+gemspec
+
+group :development do
+  gem 'rake',    '~> 10.3.2'
+  gem 'rspec',   '~> 3.1.0'
+  gem 'yard',    '~> 0.8.7'
+end
+
+group :metrics do
+  gem 'coveralls', '~> 0.7.0'
+  gem 'simplecov', '~> 0.8.2'
+  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,106 @@
+# Verse
+[![Gem Version](https://badge.fury.io/rb/verse.png)][gem]
+[![Build Status](https://secure.travis-ci.org/peter-murach/verse.png?branch=master)][travis]
+[![Code Climate](https://codeclimate.com/github/peter-murach/verse.png)][codeclimate]
+[![Coverage Status](https://coveralls.io/repos/peter-murach/verse/badge.png)][coverage]
+[![Inline docs](http://inch-ci.org/github/peter-murach/verse.png)][inchpages]
+
+[gem]: http://badge.fury.io/rb/verse
+[travis]: http://travis-ci.org/peter-murach/verse
+[codeclimate]: https://codeclimate.com/github/peter-murach/verse
+[coverage]: https://coveralls.io/r/peter-murach/verse
+[inchpages]: http://inch-ci.org/github/peter-murach/verse
+
+> Text transformations such as truncation, wrapping, aligning, indentation and grouping of words.
+
+## Features
+
+* No monkey-patching String class
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'verse'
+```
+
+And then execute:
+
+```bash
+$ bundle
+```
+
+Or install it yourself as:
+
+```bash
+$ gem install verse
+```
+
+## 1 Usage
+
+### 1.1 align
+
+**Verse** allows you to align text:
+
+```ruby
+alignment = Verse::Alignment.new "for there is no folly of the beast\n" +
+                                 " of the earth which\n" +
+                                 " is not infinitely\n" +
+                                 " outdone by the madness of men"
+```
+
+Then using `right`, `left` or `center` methods and passing width you can align the text:
+
+```ruby
+alignemnt.right(40) # =>
+    "      for there is no folly of the beast\n" +
+    "                      of the earth which\n" +
+    "                       is not infinitely\n" +
+    "           outdone by the madness of men"
+```
+
+### 1.2 truncate
+
+Using **Verse** you can truncate a given text:
+
+```ruby
+truncation = Verse::Truncation.new "for there is no folly of the beast of the earth " +
+                                   "which is not infinitely outdone by the madness of men"
+
+```
+
+Then to shorten the text to given length call `truncate`:
+
+```ruby
+truncation.truncate(20) # => "for there is no fol…"
+```
+
+### 1.3 wrap
+
+```ruby
+wrapping = Verse::Wrapping.new "Think not, is my eleventh commandment; " +
+                               "and sleep when you can, is my twelfth."
+
+```
+
+Then to wrap the text to given length call `wrap`:
+
+```ruby
+wrapping.wrap(30)
+# => "Think not, is my eleventh"
+     "commandment; and sleep when"
+     "you can, is my twelfth."
+```
+
+## Contributing
+
+1. Fork it ( https://github.com/peter-murach/verse/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 @@
+# encoding: utf-8
+
+require 'bundler/gem_tasks'
+
+FileList['tasks/**/*.rake'].each(&method(:import))
+
+desc 'Run all specs'
+task ci: %w[ spec ]

data/lib/verse.rb

@@ -0,0 +1,31 @@
+# coding: utf-8
+
+require 'verse/alignment'
+require 'verse/sanitizer'
+require 'verse/truncation'
+require 'verse/wrapping'
+require 'verse/version'
+
+module Verse
+  SPACE   = ' '.freeze
+  NEWLINE = "\n".freeze
+  TAB     = "\n".freeze
+
+  # Truncate a text at a given length
+  #
+  # @see Verse::Truncation#truncate
+  #
+  # @api public
+  def self.truncate(text, truncate_at, options = {})
+    Truncation.truncate(text, truncate_at, options)
+  end
+
+  # Wrap a text into lines at wrap length
+  #
+  # @see Verse::Wrapping#wrap
+  #
+  # @api public
+  def self.wrap(text, wrap_at, options = {})
+    Wrapping.wrap(text, wrap_at, options = {})
+  end
+end # Verse

data/lib/verse/alignment.rb

@@ -0,0 +1,94 @@
+# coding: utf-8
+
+module Verse
+  # A class responsible for text alignment
+  class Alignment
+
+    attr_reader :fill
+
+    attr_reader :direction
+
+    # Initialize an Alignment
+    #
+    # @api public
+    def initialize(text, options = {})
+      @text = text
+      @fill = options.fetch(:fill) { SPACE }
+      @direction = options.fetch(:direction) { :left }
+    end
+
+    # Aligns text to the left
+    #
+    # @return [String]
+    #
+    # @api public
+    def left(width, options = {})
+      align(width, :left, options)
+    end
+
+    # Centers text within the width
+    #
+    # @return [String]
+    #
+    # @api public
+    def center(width, options = {})
+      align(width, :center, options)
+    end
+
+    # Aligns text to the right
+    #
+    # @return [String]
+    #
+    # @api public
+    def right(width, options = {})
+      align(width, :right, options)
+    end
+
+    # Aligns text within the width.
+    #
+    # If the text is greater than the width then unmodified
+    # string is returned.
+    #
+    # @example
+    #   alignment = Verse::Alignment.new "the madness of men"
+    #
+    #   alignment.align(22, :left)
+    #   # => "the madness of men      "
+    #
+    #   alignment.align(22, :center)
+    #   # => "   the madness of men   "
+    #
+    #   alignment.align(22, :right)
+    #   # => "      the madness of men"
+    #
+    # @api public
+    def align(width, direction = :left, options = {})
+      filler = options.fetch(:fill) { fill }
+      method = convert_to_method(direction)
+      process_lines { |line| line.send(method, width, filler) }
+    end
+
+    private
+
+    # @api private
+    def convert_to_method(direction)
+      case direction
+      when :left then :ljust
+      when :right then :rjust
+      when :center then :center
+      else
+        fail ArgumentError, "Unknown alignment `#{direction}`."
+      end
+    end
+
+    # @api private
+    def process_lines
+      lines = text.split(NEWLINE)
+      lines.reduce([]) do |aligned, line|
+        aligned << yield(line.strip)
+      end.join("\n")
+    end
+
+    attr_reader :text
+  end # Alignment
+end # Verse

data/lib/verse/sanitizer.rb

@@ -0,0 +1,18 @@
+# coding: utf-8
+
+module Verse
+  class Sanitizer
+    ANSI_MATCHER = /(\[)?\033(\[)?[;?\d]*[\dA-Za-z](\])?/.freeze
+
+    # Strip ANSI characters from the text
+    #
+    # @param [String] text
+    #
+    # @return [String]
+    #
+    # @api private
+    def sanitize(text)
+      text.gsub(ANSI_MATCHER, '')
+    end
+  end # Sanitizer
+end # Verse

data/lib/verse/truncation.rb

@@ -0,0 +1,78 @@
+# coding: utf-8
+
+module Verse
+  # A class responsible for text truncation operations
+  class Truncation
+    DEFAULT_TRAILING = '…'.freeze
+
+    DEFAULT_LENGTH = 30.freeze
+
+    attr_reader :separator
+
+    attr_reader :trailing
+
+    # Initialize a Truncation
+    #
+    # @param [String] text
+    #   the text to be truncated
+    #
+    # @param [Hash] options
+    #   @option options [Symbol] :separator the character for splitting words
+    #   @option options [Symbol] :trailing  the character for ending sentence
+    #
+    # @api public
+    def initialize(text, options = {})
+      @text      = text
+      @sanitizer = Sanitizer.new
+      @separator = options.fetch(:separator) { nil }
+      @trailing  = options.fetch(:trailing) { DEFAULT_TRAILING }
+    end
+
+    # Truncate a text at a given length
+    #
+    # @see Verse::Truncation#truncate
+    #
+    # @api public
+    def self.truncate(text, truncate_at, options = {})
+      new(text).truncate(truncate_at, options)
+    end
+
+    # Truncate a text at a given length (defualts to 30)
+    #
+    # @example
+    #   truncation = Verse::Truncation.new
+    #     "The sovereignest thing on earth is parmacetti for an inward bruise."
+    #
+    #   truncation.truncate
+    #   # => "The sovereignest thing on ear…"
+    #
+    #   truncate(20)
+    #   # => "The sovereignest th…"
+    #
+    #   truncate(20, separator: ' ' )
+    #   # => "The sovereignest…"
+    #
+    #   truncate(40, trailing: '... (see more)' )
+    #   # => "The sovereignest thing on... (see more)"
+    #
+    # @api public
+    def truncate(truncate_at = DEFAULT_LENGTH, options = {})
+      if text.length <= truncate_at.to_i || truncate_at.to_i.zero?
+        return text.dup
+      end
+      trail = options.fetch(:trailing) { trailing }
+      separation = options.fetch(:separator) { separator }
+
+      chars = @sanitizer.sanitize(text).chars.to_a
+      return chars.join if chars.length <= truncate_at
+      length_without_trailing = truncate_at - trail.chars.to_a.size
+      stop = chars[0, length_without_trailing].rindex(separation)
+
+      chars[0, stop || length_without_trailing].join + trail
+    end
+
+    private
+
+    attr_reader :text
+  end # Truncation
+end # Verse

data/lib/verse/version.rb

@@ -0,0 +1,5 @@
+# coding: utf-8
+
+module Verse
+  VERSION = '0.1.0'
+end # Verse

data/lib/verse/wrapping.rb

@@ -0,0 +1,123 @@
+# coding: utf-8
+
+module Verse
+  # A class responsible for text wrapping
+  class Wrapping
+    DEFAULT_WIDTH = 80.freeze
+
+    attr_reader :indent
+
+    attr_reader :padding
+
+    # Initialize a Wrapping
+    #
+    # @param [String] text
+    #   the text to be wrapped
+    #
+    # @param [Hash] options
+    #   @option options [Symbol] :indent the indentation
+    #   @option options [Symbol] :padding the desired spacing
+    #
+    # @api public
+    def initialize(text, options = {})
+      @text    = text
+      @indent  = options.fetch(:indent) { 0 }
+      @padding = options.fetch(:padding) { [] }
+      @line_width = options.fetch(:line_width) { DEFAULT_WIDTH }
+      @sanitizer = Sanitizer.new
+    end
+
+    # Wrap a text into lines no longer than wrap_at
+    #
+    # @api public
+    def self.wrap(text, wrap_at, options = {})
+      new(text).wrap(wrap_at, options)
+    end
+
+    # Wrap a text into lines no longer than wrap_at length.
+    # Preserves existing lines and existing word boundaries.
+    #
+    # @example
+    #   wrapping = Verse::Wrapping.new "Some longish text"
+    #
+    #   wrapping.wrap(8)
+    #   # => "Some\nlongish\ntext"
+    #
+    #   wrapping.wrap(8, indent: 4)
+    #   # => >    Some
+    #        >    longish
+    #        >    text
+    #
+    # @api public
+    def wrap(wrap_at = DEFAULT_WIDTH, options = {})
+      if text.length < wrap_at.to_i || wrap_at.to_i.zero?
+        return text.dup
+      end
+
+      indentation = options.fetch(:indent) { indent }
+      spacing     = options.fetch(:padding) { padding }
+
+      text.split(NEWLINE, -1).map do |line|
+        pad_line(indent_line(wrap_line(line, wrap_at), indentation), spacing)
+      end * NEWLINE
+    end
+
+    private
+
+    # Calculate string length without color escapes
+    #
+    # @param [String] string
+    #
+    # @api private
+    def actual_length(string, at)
+      at + (string.length - @sanitizer.sanitize(string).length)
+    end
+
+    # Wrap line at given length
+    #
+    # @param [String] line
+    #
+    # @return [String]
+    #
+    # @api private
+    def wrap_line(line, at)
+      wrap_at = actual_length(line, at)
+      line.strip.gsub(/\n/, ' ').squeeze(' ')
+        .gsub(/(.{1,#{wrap_at}})(?:\s+|$\n?)|(.{1,#{wrap_at}})/, "\\1\\2\n")
+        .strip
+    end
+
+    # Indent string by given value
+    #
+    # @param [String] text
+    #
+    # @return [String]
+    #
+    # @api private
+    def indent_line(text, indent)
+      text.split(NEWLINE).each do |line|
+        line.insert(0, SPACE * indent)
+      end
+    end
+
+    # Add padding to each line in wrapped text
+    #
+    # @param [String] text
+    #   the wrapped text
+    #
+    # @return [String]
+    #
+    # @api private
+    def pad_line(text, padding)
+      return text if text.empty? || padding.empty?
+
+      padding_left  = SPACE * padding[3].to_i
+      padding_right = SPACE * padding[1].to_i
+      text.map! do |part|
+        part.insert(0, padding_left).insert(-1, padding_right)
+      end
+    end
+
+    attr_reader :text
+  end # Wrapping
+end # Verse

data/spec/spec_helper.rb

@@ -0,0 +1,49 @@
+# encoding: 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 'verse'
+
+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
+
+def unindent(text)
+  text.gsub(/^[ \t]*/, '').chomp
+end

data/spec/unit/alignment/align_spec.rb

@@ -0,0 +1,33 @@
+# coding: utf-8
+
+require 'spec_helper'
+
+RSpec.describe Verse::Alignment, '.align' do
+  it "centers line" do
+    text = "the madness of men"
+    alignment = Verse::Alignment.new(text)
+    expect(alignment.center(22)).to eq("  the madness of men  ")
+  end
+
+  it "centers multiline text" do
+    text = "for there is no folly of the beast\n of the earth which\n is not infinitely\n outdone by the madness of men"
+    alignment = Verse::Alignment.new(text)
+    expect(alignment.center(40)).to eq([
+     "   for there is no folly of the beast   \n",
+     "           of the earth which           \n",
+     "           is not infinitely            \n",
+     "     outdone by the madness of men      "
+    ].join)
+  end
+
+  it "centers multiline text with fill of '*'" do
+    text = "for there is no folly of the beast\n of the earth which\n is not infinitely\n outdone by the madness of men"
+    alignment = Verse::Alignment.new(text, fill: '*')
+    expect(alignment.center(40)).to eq([
+     "***for there is no folly of the beast***\n",
+     "***********of the earth which***********\n",
+     "***********is not infinitely************\n",
+     "*****outdone by the madness of men******"
+    ].join)
+  end
+end

data/spec/unit/alignment/left_spec.rb

@@ -0,0 +1,33 @@
+# coding: utf-8
+
+require 'spec_helper'
+
+RSpec.describe Verse::Alignment, '.left' do
+  it "aligns line to left" do
+    text = "the madness of men"
+    alignment = Verse::Alignment.new(text)
+    expect(alignment.left(22)).to eq("the madness of men    ")
+  end
+
+  it "aligns multiline text to left" do
+    text = "for there is no folly of the beast\n of the earth which\n is not infinitely\n outdone by the madness of men"
+    alignment = Verse::Alignment.new(text)
+    expect(alignment.left(40)).to eq([
+     "for there is no folly of the beast      \n",
+     "of the earth which                      \n",
+     "is not infinitely                       \n",
+     "outdone by the madness of men           "
+    ].join)
+  end
+
+  it "centers multiline text with fill of '*'" do
+    text = "for there is no folly of the beast\n of the earth which\n is not infinitely\n outdone by the madness of men"
+    alignment = Verse::Alignment.new(text, fill: '*')
+    expect(alignment.left(40)).to eq([
+     "for there is no folly of the beast******\n",
+     "of the earth which**********************\n",
+     "is not infinitely***********************\n",
+     "outdone by the madness of men***********"
+    ].join)
+  end
+end

data/spec/unit/alignment/right_spec.rb

@@ -0,0 +1,33 @@
+# coding: utf-8
+
+require 'spec_helper'
+
+RSpec.describe Verse::Alignment, '.right' do
+  it "aligns line to left" do
+    text = "the madness of men"
+    alignment = Verse::Alignment.new(text)
+    expect(alignment.right(22)).to eq("    the madness of men")
+  end
+
+  it "aligns multiline text to left" do
+    text = "for there is no folly of the beast\n of the earth which\n is not infinitely\n outdone by the madness of men"
+    alignment = Verse::Alignment.new(text)
+    expect(alignment.right(40)).to eq([
+     "      for there is no folly of the beast\n",
+     "                      of the earth which\n",
+     "                       is not infinitely\n",
+     "           outdone by the madness of men"
+    ].join)
+  end
+
+  it "centers multiline text with fill of '*'" do
+    text = "for there is no folly of the beast\n of the earth which\n is not infinitely\n outdone by the madness of men"
+    alignment = Verse::Alignment.new(text, fill: '*')
+    expect(alignment.right(40)).to eq([
+     "******for there is no folly of the beast\n",
+     "**********************of the earth which\n",
+     "***********************is not infinitely\n",
+     "***********outdone by the madness of men"
+    ].join)
+  end
+end

data/spec/unit/sanitizer/sanitize_spec.rb

@@ -0,0 +1,23 @@
+# coding: utf-8
+
+require 'spec_helper'
+
+RSpec.describe Verse::Sanitizer, '.sanitize' do
+  subject(:sanitizer) { described_class.new }
+
+  {
+    "\e[20h" => '',
+    "\e[?1h" => '',
+    "\e[20l" => '',
+    "\e[?9l" => '',
+    "\eO"    => '',
+    "\e[m"   => '',
+    "\e[0m"  => '',
+    "\eA"    => '',
+    "\e[0;33;49;3;9;4m\e[0m" => ''
+  }.each do |code, expected|
+    it "strips #{code} from string" do
+      expect(sanitizer.sanitize(code)).to eq(expected)
+    end
+  end
+end

data/spec/unit/truncate_spec.rb

@@ -0,0 +1,10 @@
+# coding: utf-8
+
+require 'spec_helper'
+
+RSpec.describe Verse, '#truncate' do
+  it "truncates text" do
+    text = 'ラドクリフ、マラソン五輪代表に1万m出場にも含み'
+    expect(Verse.truncate(text, 10)).to eq('ラドクリフ、マラソ…')
+  end
+end

data/spec/unit/truncation/new_spec.rb

@@ -0,0 +1,28 @@
+# coding: utf-8
+
+require 'spec_helper'
+
+RSpec.describe Verse::Truncation, '#new' do
+  let(:text) { 'There go the ships; there is that Leviathan whom thou hast made to play therein.'}
+
+  it "defaults to no separator and unicode trailing" do
+    truncation = Verse::Truncation.new text
+    expect(truncation.separator).to eq(nil)
+  end
+
+  it "defaults to unicode trailing" do
+    truncation = Verse::Truncation.new text
+    expect(truncation.trailing).to eq('…')
+  end
+
+
+  it "allows to setup global separator value" do
+    truncation = Verse::Truncation.new text, separator: ' '
+    expect(truncation.separator).to eq(' ')
+  end
+
+  it "allows to setup global trailing value" do
+    truncation = Verse::Truncation.new text, trailing: '...'
+    expect(truncation.trailing).to eq('...')
+  end
+end

data/spec/unit/truncation/truncate_spec.rb

@@ -0,0 +1,63 @@
+# coding: utf-8
+
+require 'spec_helper'
+
+RSpec.describe Verse::Truncation, '.truncate' do
+  let(:text) { 'ラドクリフ、マラソン五輪代表に1万m出場にも含み' }
+
+  it "doesn't change text for 0 length" do
+    truncation = Verse::Truncation.new(text)
+    expect(truncation.truncate(0)).to eq(text)
+  end
+
+  it "doensn't change text for nil length" do
+    truncation = Verse::Truncation.new(text)
+    expect(truncation.truncate(nil)).to eq(text)
+  end
+
+  it "doesn't change text for equal length" do
+    truncation = Verse::Truncation.new(text)
+    expect(truncation.truncate(text.length)).to eq(text)
+  end
+
+  it 'truncates text' do
+    truncation = Verse::Truncation.new(text)
+    trailing = '…'
+    expect(truncation.truncate(12)).to eq("ラドクリフ、マラソン五#{trailing}")
+  end
+
+  it "doesn't truncate text when length exceeds content" do
+    truncation = Verse::Truncation.new(text)
+    expect(truncation.truncate(100)).to eq(text)
+  end
+
+  it 'truncates text with string separator' do
+    truncation = Verse::Truncation.new(text)
+    trailing = '…'
+    expect(truncation.truncate(12, separator: ' ')).to eq("ラドクリフ、マラソン五#{trailing}")
+  end
+
+  it 'truncates text with regex separator' do
+    truncation = Verse::Truncation.new(text)
+    trailing = '…'
+    expect(truncation.truncate(12, separator: /\s/)).to eq("ラドクリフ、マラソン五#{trailing}")
+  end
+
+  it 'truncates text with custom trailing' do
+    truncation = Verse::Truncation.new(text)
+    trailing = '... (see more)'
+    expect(truncation.truncate(20, trailing: trailing)).to eq("ラドクリフ、#{trailing}")
+  end
+
+  it 'correctly truncates with ANSI characters' do
+    text = "This is a \e[1m\e[34mbold blue text\e[0m"
+    truncation = Verse::Truncation.new(text)
+    expect(truncation.truncate).to eq 'This is a bold blue text'
+  end
+
+  it "finishes on word boundary" do
+    text = "for there is no folly of the beast of the earth"
+    truncation = Verse::Truncation.new(text)
+    expect(truncation.truncate(20, separator: ' ')).to eq('for there is no…')
+  end
+end

data/spec/unit/wrap_spec.rb

@@ -0,0 +1,10 @@
+# coding: utf-8
+
+require 'spec_helper'
+
+RSpec.describe Verse, '#wrap' do
+  it "wraps text" do
+    text = 'ラドクリフ、マラソン五輪代表に1万m出場にも含み'
+    expect(Verse.wrap(text, 8)).to eql("ラドクリフ、マラ\nソン五輪代表に1\n万m出場にも含み")
+  end
+end

data/spec/unit/wrapping/new_spec.rb

@@ -0,0 +1,27 @@
+# coding: utf-8
+
+require 'spec_helper'
+
+RSpec.describe Verse::Wrapping, '#new' do
+  let(:text) { "There go the ships; there is that Leviathan whom thou hast made to play therein."}
+
+  it "defaults indentation to 0" do
+    wrapping = Verse::Wrapping.new(text)
+    expect(wrapping.indent).to eq(0)
+  end
+
+  it "defaults paddnig to empty array" do
+    wrapping = Verse::Wrapping.new(text)
+    expect(wrapping.padding).to eq([])
+  end
+
+  it "allows to set global indenation" do
+    wrapping = Verse::Wrapping.new(text, indent: 5)
+    expect(wrapping.indent).to eq(5)
+  end
+
+  it "allows to set global padding" do
+    wrapping = Verse::Wrapping.new(text, padding: [1,2,3,4])
+    expect(wrapping.padding).to eq([1,2,3,4])
+  end
+end

data/spec/unit/wrapping/wrap_spec.rb

@@ -0,0 +1,88 @@
+# coding: utf-8
+
+require 'spec_helper'
+
+RSpec.describe Verse::Wrapping, '.wrap' do
+  context 'when unicode' do
+    let(:text) { 'ラドクリフ、マラソン五輪代表に1万m出場にも含み' }
+
+    it "doesn't wrap at zero length" do
+      wrapping = Verse::Wrapping.new(text)
+      expect(wrapping.wrap(0)).to eq(text)
+    end
+
+    it "doesn't wrap at nil length" do
+      wrapping = Verse::Wrapping.new(text)
+      expect(wrapping.wrap(nil)).to eq(text)
+    end
+
+    it 'wraps at 8 characters' do
+      wrapping = Verse::Wrapping.new(text)
+      expect(wrapping.wrap(8)).to eq("ラドクリフ、マラ\nソン五輪代表に1\n万m出場にも含み")
+    end
+
+    it "doesn't wrap at length exceeding content length" do
+      wrapping = Verse::Wrapping.new(text)
+      expect(wrapping.wrap(100)).to eq(text)
+    end
+  end
+
+  context 'when long text' do
+    it "wraps long text at 45 characters" do
+      text =
+      "What of it, if some old hunks of a sea-captain orders me to get a broom
+      and sweep down the decks? What does that indignity amount to, weighed,
+      I mean, in the scales of the New Testament? Do you think the archangel
+      Gabriel thinks anything the less of me, because I promptly and
+      respectfully obey that old hunks in that particular instance? Who ain't
+      a slave? Tell me that. Well, then, however the old sea-captains may
+      order me about--however they may thump and punch me about, I have the
+      satisfaction of knowing that it is all right;
+      "
+      wrapping = Verse::Wrapping.new(text)
+      expect(wrapping.wrap(45)).to eq unindent <<-EOS
+    What of it, if some old hunks of a\n sea-captain orders me to get a broom
+    and sweep down the decks? What does that\n indignity amount to, weighed,
+    I mean, in the scales of the New Testament?\n Do you think the archangel
+    Gabriel thinks anything the less of me,\n because I promptly and
+    respectfully obey that old hunks in that\nparticular instance? Who ain't
+    a slave? Tell me that. Well, then, however\n the old sea-captains may
+    order me about--however they may thump and\n punch me about, I have the
+    satisfaction of knowing that it is all right;\n
+      EOS
+    end
+  end
+
+  context 'when indented' do
+    let(:length) { 8 }
+    let(:indent) { 4 }
+
+    it "wraps with indentation" do
+      text = 'ラドクリフ、マラソン五輪代表に1万m出場にも含み'
+      wrapping = Verse::Wrapping.new(text)
+      expect(wrapping.wrap(8, indent: 4)).to eq("    ラドクリフ、マラ\n    ソン五輪代表に1\n    万m出場にも含み")
+    end
+  end
+
+  context 'with ansi colors' do
+    it "wraps text with ANSII codes" do
+      text = "\[\033[01;32m\]Hey have\[\033[01;34m\]some cake\[\033[00m\]"
+      wrapping = Verse::Wrapping.new(text)
+      expect(wrapping.wrap(8)).to eq("\[\033[01;32m\]Hey have\[\033[01;34m\]some\ncake\[\033[00m\]")
+    end
+  end
+
+  context 'with newlines' do
+    it "preserves newlines for both prefix and postfix" do
+      text = "\n\nラドクリフ、マラソン五輪代表に1万m出場にも含み\n\n\n"
+      wrapping = Verse::Wrapping.new(text)
+      expect(wrapping.wrap(10)).to eq("\n\nラドクリフ、マラソン\n五輪代表に1万m出場\nにも含み\n\n\n")
+    end
+
+    it "preserves newlines with padding" do
+      text = "\n\nラドクリフ、マラソン五輪代表に1万m出場にも含み\n\n"
+      wrapping = Verse::Wrapping.new(text)
+      expect(wrapping.wrap(10, padding: [1,2,3,4])).to eq("\n\n    ラドクリフ、マラソン  \n    五輪代表に1万m出場  \n    にも含み  \n\n")
+    end
+  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/verse')
+  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/verse.gemspec

@@ -0,0 +1,22 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'verse/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "verse"
+  spec.version       = Verse::VERSION
+  spec.authors       = ["Piotr Murach"]
+  spec.email         = [""]
+  spec.summary       = %q{}
+  spec.description   = %q{}
+  spec.homepage      = ""
+  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{^(spec)/})
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'bundler', '~> 1.5'
+end

metadata

@@ -0,0 +1,99 @@
+--- !ruby/object:Gem::Specification
+name: verse
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Piotr Murach
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-02-07 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.5'
+description: ''
+email:
+- ''
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- .ruby-version
+- .travis.yml
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/verse.rb
+- lib/verse/alignment.rb
+- lib/verse/sanitizer.rb
+- lib/verse/truncation.rb
+- lib/verse/version.rb
+- lib/verse/wrapping.rb
+- spec/spec_helper.rb
+- spec/unit/alignment/align_spec.rb
+- spec/unit/alignment/left_spec.rb
+- spec/unit/alignment/right_spec.rb
+- spec/unit/sanitizer/sanitize_spec.rb
+- spec/unit/truncate_spec.rb
+- spec/unit/truncation/new_spec.rb
+- spec/unit/truncation/truncate_spec.rb
+- spec/unit/wrap_spec.rb
+- spec/unit/wrapping/new_spec.rb
+- spec/unit/wrapping/wrap_spec.rb
+- tasks/console.rake
+- tasks/coverage.rake
+- tasks/spec.rake
+- verse.gemspec
+homepage: ''
+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: ''
+test_files:
+- spec/spec_helper.rb
+- spec/unit/alignment/align_spec.rb
+- spec/unit/alignment/left_spec.rb
+- spec/unit/alignment/right_spec.rb
+- spec/unit/sanitizer/sanitize_spec.rb
+- spec/unit/truncate_spec.rb
+- spec/unit/truncation/new_spec.rb
+- spec/unit/truncation/truncate_spec.rb
+- spec/unit/wrap_spec.rb
+- spec/unit/wrapping/new_spec.rb
+- spec/unit/wrapping/wrap_spec.rb
+has_rdoc: