st_tools 0.3.8 → 0.3.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: a88a647c0f49b178c918012abe51b2726ecf6df2
-  data.tar.gz: a337d8e0a59aae2051b5d9aaa628f02c08d8f352
+  metadata.gz: 43ec9fa72dac604d2acb1fda81c52417ccf5c2cd
+  data.tar.gz: 04f54d9f33e84cf8f9cfa8ec05072ae58c56c436
 SHA512:
-  metadata.gz: df2417819b173f060738656706bfd3f1d643707a822cc4274bc58114cd6f4e9036c485702f883000b6a6b5ea75d3a9f8cdc2cf812a2f980a0bf97806588ba81c
-  data.tar.gz: b10f05b28ae6266b5e6319ec54c62023a0f20efb77181b2f75dc6faf4c8406dc16ce322ac8bad19981d6bdd5f6ba8e228ac710865c9f1be519bf9fb3dbc120c7
+  metadata.gz: a74cac459d7d97a7e3a9d5e4de5a9419a64f993b8a81a5e3ac24b9ce18db7de1d29f02ffae9f7007c5580e335164ddb90aa5b00c06d3093935e3bc26b54dd5a9
+  data.tar.gz: b3d422acf564373ecfc93de98307cdadc76ff8e644fbbb8a3262318674c138c7cab9c20539e068c410297ae79ea47e05084ee576ce509e4991733589a8140333

data/README.md

@@ -237,6 +237,23 @@ StTools::Setup.setup(:en)
     # => "Discount is <em>$100</em> or <em>$200</em>"
 ```
 
+В ряде случаев необходимо обрезать строку таким образом, чтобы на экране уместилась часть строки, и многоточие,
+которе показывает, что строка была сокращена. Для этого можно использовать метод `StTools::String.prune`.
+
+```ruby
+StTools::String.prune("1234567890", 20)                   #=> "1234567890"
+StTools::String.prune("1234567890", 8)                    #=> "12345..."
+StTools::String.prune("1234567890", 8, endwidth: '---')   #=> "12345---"
+StTools::String.prune("Привет мир!", 12)                  #=> "Привет ми..."
+StTools::String.prune("Привет мир!", 12, words: true)     #=> "Привет..."
+```
+
+Следует обратить внимание на два момента. Во-первых, строка обрезается до указанной длины ПЛЮС длина завершающего многточия.
+То есть при указании `StTools::String.prune("1234567890", 5)` результат будет `"12..."`. Во-вторых, если указать параметр
+`word: true`, то произойдет более "умное" обрезание фразы - не посреди слова (как показано в примере выше), а по границе
+слова, то есть по пробелу между словами в меньшую сторону.
+
+
 Вы можете подмешать модуль `StTools::Module` в классы String, Integer, Time.
 
 ```ruby

data/lib/modules/string.rb

@@ -90,6 +90,19 @@ module StTools
         ::StTools::String.caps(self)
       end
 
+      # Метод обрезает строку и добавляет в случае обрезнаия многоточие
+      #
+      # @return [String] сокращенная строка строка
+      # @example Обрезание строки
+      #   "1234567890".prune(20)                  #=> "1234567890"
+      #   "1234567890".prune(8)                   #=> "12345..."
+      #   "1234567890".prune(8, endwidth: '---')  #=> "12345---"
+      #   "Привет мир!".prune(12)                 #=> "Привет ми..."
+      #   "Привет мир!".prune(12, words: true)    #=> "Привет..."
+      def prune(length, words: false, endwith: '...')
+        ::StTools::String.prune(self, length, words, endwith)
+      end
+
       # Метод переводит строку в значение boolean (true или false). True - если строка имеет одно из трех значений:
       # ['true', 'on', '1']
       #

data/lib/st_tools/fias.rb

@@ -110,7 +110,7 @@ module StTools
     #   StTools::Fias.postalcode?('1234') #=> false
     def self.postalcode?(text)
       return nil if text.nil?
-      if text.to_s.strip.match(/^\d{6}$/)
+      if text.to_s.strip.match(/\A\d{6}\z/)
         return true
       end
       return false

data/lib/st_tools/string.rb

@@ -171,7 +171,7 @@ module StTools
       return nil if text.nil?
       str = self.downcase(text)
       str.gsub!(/(^[а-яa-z]|[а-яa-z\s]-[а-яa-z]|[\.\s\_][а-яa-z])/) do |part|
-        part.gsub(/.\b$/) { |x| self.upcase(x) }
+        part.gsub(/.\b\z/) { |x| self.upcase(x) }
       end
       return str
     rescue
@@ -243,5 +243,28 @@ module StTools
       out.join
     end
 
+    # Метод обрезает строку и добавляет в случае обрезания строки многоточие
+    #
+    # @param [Object] text строка для обрезания
+    # @param [Object] length необходимая длина строки С УЧЕТОМ окончания (многоточия)
+    # @param [Object] words если true, то не будет слов "разрезанных" на части. По умолчанию false
+    # @param [Object] endwith завершающее многоточие (по умолчанию '...')
+    # @return [String] сокращенная строка строка
+    # @example Примеры использования
+    #   StTools::String.prune("1234567890", 20)                   #=> "1234567890"
+    #   StTools::String.prune("1234567890", 8)                    #=> "12345..."
+    #   StTools::String.prune("1234567890", 8, endwidth: '---')   #=> "12345---"
+    #   StTools::String.prune("Привет мир!", 12)                  #=> "Привет ми..."
+    #   StTools::String.prune("Привет мир!", 12, words: true)     #=> "Привет..."
+    def self.prune(text, length, words: false, endwith: '...')
+      return '' if text.nil? || text == ''
+      return text if text.length <= length
+      return text[0, length] if length <= endwith.length
+
+      out = text.strip[0,length - endwith.length]
+      out.gsub!(/\s.+\z/, '') if words
+      out.strip + endwith
+    end
+
   end
 end

data/lib/st_tools/version.rb

@@ -1,3 +1,3 @@
 module StTools
-  VERSION = '0.3.8'
+  VERSION = '0.3.9'
 end

data/test/string_lib_spec.rb

@@ -139,5 +139,19 @@ describe 'Проверка методов StTools::String.*' do
     expect(test).to eq('<em>Паша</em>, <em>Маша</em> or <em>Саша</em>')
   end
 
+  it 'prune' do
+    test = ::StTools::String.prune('1234567890', 20)
+    expect(test).to eq('1234567890')
+    test = ::StTools::String.prune('1234567890', 8)
+    expect(test).to eq('12345...')
+    test = ::StTools::String.prune('1234567890', 8, words: true)
+    expect(test).to eq('12345...')
+    test = ::StTools::String.prune('1234567890', 8, words: true, endwith: '---')
+    expect(test).to eq('12345---')
+    test = ::StTools::String.prune('Привет мир и природа', 12)
+    expect(test).to eq('Привет ми...')
+    test = ::StTools::String.prune('Привет мир и природа', 12, words: true)
+    expect(test).to eq('Привет...')
+  end
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: st_tools
 version: !ruby/object:Gem::Version
-  version: 0.3.8
+  version: 0.3.9
 platform: ruby
 authors:
 - Stan Zhuravlev
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2015-05-31 00:00:00.000000000 Z
+date: 2015-06-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler