st_tools 0.3.7 → 0.3.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 9db3fa6dd4099dfcecfe2d25cd33aad9a2d0af51
-  data.tar.gz: 16898f9a9f298572600b11c61220bfa8ccfbb117
+  metadata.gz: a88a647c0f49b178c918012abe51b2726ecf6df2
+  data.tar.gz: a337d8e0a59aae2051b5d9aaa628f02c08d8f352
 SHA512:
-  metadata.gz: 15e8352e574b673a287db3c7a83b91ac9fddc368b50584caf0b138616127b91caffed2a1395695456056c65cd704e6dc02f37c974f1c4261844a2494d808914a
-  data.tar.gz: 8c92502e4e9c7e5b3e1ce931a644e96145febac502d1f74ded2e58a2d1d7cd8a0506ffcdfe4614056b65acd043a8e25a2fd7c4f20f8bd3cd96d6d85946c3d6b2
+  metadata.gz: df2417819b173f060738656706bfd3f1d643707a822cc4274bc58114cd6f4e9036c485702f883000b6a6b5ea75d3a9f8cdc2cf812a2f980a0bf97806588ba81c
+  data.tar.gz: b10f05b28ae6266b5e6319ec54c62023a0f20efb77181b2f75dc6faf4c8406dc16ce322ac8bad19981d6bdd5f6ba8e228ac710865c9f1be519bf9fb3dbc120c7

data/README.md

@@ -221,6 +221,22 @@ StTools::String.to_range('54, 3-6, 5, 1', uniq: true)                     # => [
 StTools::String.to_range('54, 3-6, 5, 1', uniq: true, sort: true)         # => [1, 3, 5, 6, 54]
 ```
 
+Следующий метод `pretty_list` позволяет сделать human-подобное оформление списков-перечислений.
+
+```ruby
+StTools::Setup.setup(:ru)
+'Мы работаем ' + StTools::String.pretty_list([4,5,6]) + ' мая'
+    # => "Мы работаем 4, 5 и 6 мая"
+'Доехать можно на трамваях ' + StTools::String.pretty_list([67, 89], union: :or) + ' маршрутов'
+    # => "Доехать можно на трамвае 67 или 89 маршрутов"
+'Скидка составит ' + StTools::String.pretty_list([100, 200], union: :or, pretag: '<em>', afttag: '</em>') + ' руб.'
+    # => "Скидка составит <em>100</em> или <em>200</em> руб."
+
+StTools::Setup.setup(:en)
+'Discount is ' + StTools::String.pretty_list([100, 200], union: :or, pretag: '<em>$', afttag: '</em>')
+    # => "Discount is <em>$100</em> or <em>$200</em>"
+```
+
 Вы можете подмешать модуль `StTools::Module` в классы String, Integer, Time.
 
 ```ruby

data/lib/i18n/en.yml

@@ -69,4 +69,9 @@ en:
       second:
         one: second
         two: seconds
-        other: seconds
+        other: seconds
+
+  string:
+    pretty_list:
+      and: and
+      or: or

data/lib/i18n/ru.yml

@@ -46,4 +46,9 @@ ru:
       second:
         one: секунда
         two: секунды
-        other: секунд
+        other: секунд
+
+  string:
+    pretty_list:
+      and: и
+      or: или

data/lib/st_tools/string.rb

@@ -206,5 +206,42 @@ module StTools
       false
     end
 
+    # Метод преобразует список Array в строку перечисление вида "это, это и это". Метод позволяет
+    # делать перечсиелние на разных языках, использовать частицы 'и' и 'или', а также оформлять
+    # список тегами HTML.
+    #
+    # @param [Array] items массив значений для оформления в виде списка
+    # @param [String] separator знак разделитель, по умолчанию запятая (',')
+    # @param [Sym] union признак частицы, если указать :and, то будет использована частица 'и', либо 'или' в других случаях
+    # @param [String] pretag открывающий тег HTML для обрамления элементов списка
+    # @param [String] afttag закрывающий тег HTML для обрамления элементов списка
+    #
+    # @return [String] конвертированная строка
+    # @example Примеры использования
+    #   StTools::Setup.setup(:ru)
+    #   StTools::String.pretty_list([1,2])                      #=> "1 и 2"
+    #   StTools::String.pretty_list([1,2,4])                    #=> "1, 2 и 4"
+    #   StTools::String.pretty_list([1,2,3,4], union: :or)      #=> "1, 2, 3 или 4"
+    def self.pretty_list(items, separator: ',', union: :and, pretag: '', afttag: '')
+      return '' if items.nil? || items.empty?
+      return "#{pretag}#{items.first}#{afttag}" if items.count == 1
+      out = Array.new
+      last = items.last
+      arr = items[0,items.count-1]
+      arr.each do |one|
+        out << "#{pretag}#{one}#{afttag}"
+        out << separator + ' '
+      end
+      out.pop
+      case union
+        when :and
+          out << " #{I18n.t('string.pretty_list.and')} "
+        else
+          out << " #{I18n.t('string.pretty_list.or')} "
+      end
+      out << "#{pretag}#{last}#{afttag}"
+      out.join
+    end
+
   end
 end

data/lib/st_tools/version.rb

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

data/test/string_lib_spec.rb

@@ -106,5 +106,38 @@ describe 'Проверка методов StTools::String.*' do
     expect(test).to eq(false)
   end
 
+  it 'pretty_list(nil)' do
+    test = ::StTools::String.pretty_list(nil)
+    expect(test).to eq('')
+  end
+
+  it 'pretty_list - ru' do
+    ::StTools::Setup.setup(:ru)
+    test = ::StTools::String.pretty_list(['Паша'])
+    expect(test).to eq('Паша')
+    test = ::StTools::String.pretty_list(['Паша', 'Маша'])
+    expect(test).to eq('Паша и Маша')
+    test = ::StTools::String.pretty_list(['Паша', 'Маша', 'Саша'])
+    expect(test).to eq('Паша, Маша и Саша')
+    test = ::StTools::String.pretty_list(['Паша', 'Маша', 'Саша'], union: :or)
+    expect(test).to eq('Паша, Маша или Саша')
+    test = ::StTools::String.pretty_list(['Паша', 'Маша', 'Саша'], union: :or, pretag: '<em>', afttag: '</em>')
+    expect(test).to eq('<em>Паша</em>, <em>Маша</em> или <em>Саша</em>')
+  end
+
+  it 'pretty_list - en' do
+    ::StTools::Setup.setup(:en)
+    test = ::StTools::String.pretty_list(['Паша'])
+    expect(test).to eq('Паша')
+    test = ::StTools::String.pretty_list(['Паша', 'Маша'])
+    expect(test).to eq('Паша and Маша')
+    test = ::StTools::String.pretty_list(['Паша', 'Маша', 'Саша'])
+    expect(test).to eq('Паша, Маша and Саша')
+    test = ::StTools::String.pretty_list(['Паша', 'Маша', 'Саша'], union: :or)
+    expect(test).to eq('Паша, Маша or Саша')
+    test = ::StTools::String.pretty_list(['Паша', 'Маша', 'Саша'], union: :or, pretag: '<em>', afttag: '</em>')
+    expect(test).to eq('<em>Паша</em>, <em>Маша</em> or <em>Саша</em>')
+  end
+
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: st_tools
 version: !ruby/object:Gem::Version
-  version: 0.3.7
+  version: 0.3.8
 platform: ruby
 authors:
 - Stan Zhuravlev
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2015-05-20 00:00:00.000000000 Z
+date: 2015-05-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -117,7 +117,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - "~>"
     - !ruby/object:Gem::Version
-      version: '2.0'
+      version: 2.2.1
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="