nrser 0.0.6 → 0.0.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 5c8731154cddca4f094d4d430d8250c736787828
-  data.tar.gz: 8e721938ec4c42a38710af59b3a5d2523e7a2a72
+  metadata.gz: 5613f267360bdb2ff8af4120116b59d1e348f90c
+  data.tar.gz: 5492a2ffd330274e01e7ce83110877c55adae7e4
 SHA512:
-  metadata.gz: e2944482bc327588d1a9320768176b26ccb17409a76c4a39f39dac94b5dc9f77c1bd5799009b7eb49dfdeb670b055622ede08906169525d3aee0a81f49301610
-  data.tar.gz: 274e7e3bf113716008789a1104a3aed27be1338708565587461239a61a030d3a714c13a9f72e137542dc9e265c2f4f157d3242f3619b8ad85402db9d057874c3
+  metadata.gz: dc4f080da2d7ab98526674983acc1d4f1c08d1319ff96d2ccc6740dd4b6ab4dbd692c68e36fc51e46db1286131660ccac2fb03493cc7e736ced9a89175ea0288
+  data.tar.gz: 1aa2be5f247e7b23808e1ee07d6116627f54182d3507cfffb13f6dd76171d0ade34ca6b83c7dbc44bca9aea15d3024ca4e21fb5ddae82d209f6b87d4a192e794

data/lib/nrser/version.rb

@@ -1,3 +1,3 @@
 module NRSER
-  VERSION = "0.0.6"
+  VERSION = "0.0.7"
 end

data/lib/nrser.rb

@@ -28,6 +28,10 @@ module NRSER
     def indent
       NRSER.indent self
     end
+
+    def truncate *args
+      NRSER.truncate self, *args
+    end
   end # refine String
 
   refine Exception do
@@ -107,4 +111,41 @@ module NRSER
     str.gsub(re, indent_string * amount)
   end
 
+  # Truncates a given +text+ after a given <tt>length</tt> if +text+ is longer than <tt>length</tt>:
+  #
+  #   'Once upon a time in a world far far away'.truncate(27)
+  #   # => "Once upon a time in a wo..."
+  #
+  # Pass a string or regexp <tt>:separator</tt> to truncate +text+ at a natural break:
+  #
+  #   'Once upon a time in a world far far away'.truncate(27, separator: ' ')
+  #   # => "Once upon a time in a..."
+  #
+  #   'Once upon a time in a world far far away'.truncate(27, separator: /\s/)
+  #   # => "Once upon a time in a..."
+  #
+  # The last characters will be replaced with the <tt>:omission</tt> string (defaults to "...")
+  # for a total length not exceeding <tt>length</tt>:
+  #
+  #   'And they found that many people were sleeping better.'.truncate(25, omission: '... (continued)')
+  #   # => "And they f... (continued)"
+  # 
+  # adapted from 
+  # 
+  # <https://github.com/rails/rails/blob/7847a19f476fb9bee287681586d872ea43785e53/activesupport/lib/active_support/core_ext/string/filters.rb#L46>
+  # 
+  def self.truncate(str, truncate_at, options = {})
+    return str.dup unless str.length > truncate_at
+
+    omission = options[:omission] || '...'
+    length_with_room_for_omission = truncate_at - omission.length
+    stop = \
+      if options[:separator]
+        str.rindex(options[:separator], length_with_room_for_omission) || length_with_room_for_omission
+      else
+        length_with_room_for_omission
+      end
+
+    "#{str[0, stop]}#{omission}"
+  end
 end

data/spec/nrser/truncate_spec.rb

@@ -0,0 +1,17 @@
+require 'spec_helper'
+
+using NRSER
+
+describe "NRSER.truncate" do
+  it "truncates a string that's longer than length" do
+    expect( NRSER.truncate "blah blah blah blah", 10 ).to eq "blah bl..."
+  end
+
+  it "leaves a string alone that's shorter or equal to lenght" do
+    expect( NRSER.truncate "blah", 10 ).to eq "blah"
+  end
+
+  it "refines String" do
+    expect( "blah blah blah blah".truncate 10 ).to eq "blah bl..."
+  end
+end # indent

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: nrser
 version: !ruby/object:Gem::Version
-  version: 0.0.6
+  version: 0.0.7
 platform: ruby
 authors:
 - nrser
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-03-18 00:00:00.000000000 Z
+date: 2015-03-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -77,6 +77,7 @@ files:
 - spec/nrser/format_exception_spec.rb
 - spec/nrser/indent_spec.rb
 - spec/nrser/template_spec.rb
+- spec/nrser/truncate_spec.rb
 - spec/nrser_spec.rb
 - spec/spec_helper.rb
 - tmp/.gitkeep
@@ -112,5 +113,6 @@ test_files:
 - spec/nrser/format_exception_spec.rb
 - spec/nrser/indent_spec.rb
 - spec/nrser/template_spec.rb
+- spec/nrser/truncate_spec.rb
 - spec/nrser_spec.rb
 - spec/spec_helper.rb