st_tools 0.3.3 → 0.3.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b9636bb4e4a7eca384e243785b78add9c259fee4
-  data.tar.gz: c336f6ba172b1df7cf029f0ab62704e473e02aef
+  metadata.gz: 4db6237dd025a2faff39e7caf42712420fd75fe8
+  data.tar.gz: a4ce8b4cde0167699f06717f5fc56d840e43050b
 SHA512:
-  metadata.gz: 50aaa34a9388dffdf0bc3459bfbdefa5240ab9e1437af0395871e4967119b1fb1a633d1dd4feccb05c56d060f69265785f70c889f1d179b6e7fd7396dd606180
-  data.tar.gz: 046ff39698e836e0f6753ccd3e80520c42151b647d0daa6dfa3efc7ffa311e816c809d9c9aa6cc6cfc66d3fc6aec5de62f3b17e7f72de97a1aba6b76cd89263e
+  metadata.gz: 8cf673e6c075cd4eead80ea445a2a97295ea3671e0292432f9d0711fd10f2fb693ffad4acfa5a5daf596c75fe6175d3dfe5735fae47bed6e4a596564b3a218ea
+  data.tar.gz: fcb305b608f8ef9ebabd66cb42967ef284df590246988b8c3e0e83e9f24264eec4b24dbee67eec0405ce4505cd6a79eeb2932b1de418a11f4985186eb298d57b

data/README.md

@@ -70,14 +70,27 @@ StTools.Human.ago_in_words(Time.now - 15, true)                   # => 15 сек
 
 ```ruby
 StTools::Setup.setup(:en)
-StTools.Human.ago_in_words(DateTime.new(2014,12,31), true)        # => 4 months 21 days ago
-StTools.Human.ago_in_words(DateTime.new(2013,08,01), false)       # => 1 year 8 months
-StTools.Human.ago_in_words(Time.now - 15, true)                   # => 15 seconds ago
+StTools.Human.human_ago(DateTime.new(2014,12,31), true)        # => 4 months 21 days ago
+StTools.Human.human_ago(DateTime.new(2013,08,01), false)       # => 1 year 8 months
+StTools.Human.human_ago(Time.now - 15, true)                   # => 15 seconds ago
 ```
 
 Устанавливая флаг ```ago=true```, метод добавит слово "назад" или "ago" в конце фразы.
 
-Результирующая фраза всегда состоит из одного показатели (при разнице времени событий меньше минуты) или из двух (минуты/секунды, часы/минуты, дни/часы, месяцы/дни, года/месяцы)
+Результирующая фраза всегда состоит из одного показатели (при разнице времени событий меньше минуты)
+или из двух (минуты/секунды, часы/минуты, дни/часы, месяцы/дни, года/месяцы)
+
+Иногда возникает другой кейс, когда нужно рассчитать разницу во времени не относительно текущей даты,
+а относительно любых двух произвольных событий. Для этого может использоваться метод, в который передается
+не временная метка, а просто количество секунд между двумя событиями.
+
+```ruby
+StTools::Setup.setup(:ru)
+.seconds_ago(DateTime.new(2014,12,31), true)        # => 4 months 21 days ago
+StTools.Human.seconds_ago(DateTime.new(2013,08,01), false)       # => 1 year 8 months
+StTools.Human.seconds_ago(Time.now - 15, true)                   # => 15 seconds ago
+```
+
 
 Вы имеете форматировать дату и время в соответствии с правилами русского и английского языка.
 
@@ -107,7 +120,7 @@ StTools.Human.format_time(Time.now, :time, :short)             # => 09:45 am
 StTools::Setup.setup(:ru)
 
 class String
-   extend StTools::Module::String
+   include StTools::Module::String
 end
 
 (Time.now - 15).human_ago                         # => 15 секунд назад
@@ -129,7 +142,7 @@ StTools::String.translit('Жмеринка')                  # => Zhmerinka
 StTools::String.delat('Соль')                         # => Соль
 ```
 
-Перевести строку в верхний или нижний регистр. Используется метод, альтернативный mb_chars (примерно в два раза производительней)
+Перевести строку в верхний или нижний регистр. Используется метод, не использующий :mb_chars
 
 ```ruby
 StTools::String.downcase('Москва')                    # => москва
@@ -196,7 +209,7 @@ StTools::String.to_range('54, 3-6, 5, 1', uniq: true, sort: true)         # => [
 StTools::Setup.setup(:ru)
 
 class String
-   extend StTools::Module::String
+   include StTools::Module::String
 end
 
 'санКТ-петерБург'.caps                         # => Санкт-Петербург

data/lib/modules/integer.rb

@@ -2,7 +2,7 @@ module StTools
   module Module
     module Integer
 
-      # Переводит число в строку с размером в байтах, кбайтах, Мбайтах и пр.
+      # Переводит число в строку с размером в 'тыс.', 'млн.', 'трлн.' и пр.
       #
       # @return [String] строка с суффиксом
       def human_number
@@ -19,10 +19,27 @@ module StTools
       # Переводит число в значение boolean (true или false). Любое число false кроме 1 (единицы)
       #
       # @return [Boolean] true или false
+      # @example Примеры использования
+      #   StTools::String.to_bool("1")       #=> true
+      #   StTools::String.to_bool("0")       #=> false
+      #   StTools::String.to_bool("10")      #=> false
+      #   StTools::String.to_bool("-3")      #=> false
       def to_bool
         ::StTools::String.to_bool(self)
       end
 
+      # Метод переводит целое число (число секунд) в человеко-удобное время в виде "1 минута 15 секунд назад"
+      #
+      # @return [String] строка с указанием количества секунд в форме "1 минута 15 секунд назад"
+      # @example Примеры использования
+      #   StTools::Setup.setup(:ru)
+      #   345.seconds_ago                #=> "5 минут 45 секунд назад"
+      #   24553.seconds_ago(false)       #=> 6 часов 49 минут"
+      #   7364563738.seconds_ago         #=> "233 года 45 месяцев назад"
+      def seconds_ago(ago = true)
+        ::StTools::Human.seconds_ago(self, ago)
+      end
+
     end
   end
 end

data/lib/modules/string.rb

@@ -63,7 +63,7 @@ module StTools
       # @return [Array] массив чисел
       # @example Преобразование строки в массив чисел
       #   "Москва , Питер , Владимир".split(",") #=> ['москва', 'питер', 'владимир']
-      def split(separator, opts = {})
+      def st_split(separator, opts = {})
         ::StTools::String.split(self, separator, opts)
       end
 
@@ -100,6 +100,19 @@ module StTools
         ::StTools::String.to_bool(self)
       end
 
+      private
+
+      # Удаляем функции downcase, upcase из оригинального класса String
+      # чтобы вместо них вызывались новые функции из модуля StTools::Module::String
+      # Если этого не делать, то всегда будут вызываться соответствующие методы оригинального
+      # класса String
+      def self.included(klass)
+        klass.class_eval do
+          remove_method :downcase
+          remove_method :upcase
+        end
+      end
+
     end
   end
 end

data/lib/modules/time.rb

@@ -2,20 +2,67 @@ module StTools
   module Module
     module Time
 
+      # Метод переводит Date в строку на русском или иных языках. Предварительно необходимо вызвать
+      # StTools.setup(:ru или :en).
+      #
+      # @param [Date] time исходная дата
+      # @param [Sym] type форма в которой возращать результат: длинная ("28 апреля 2015 г.") или короткая ("28/04/2015")
+      # @option :full длинна форма
+      # @option :short короткая форма
+      # @return [String] строка с форматированной датой
+      # @example Примеры использования
+      #   StTools::Setup.setup(:ru)
+      #   Time.now.human_date(:full)       #=> "30 апреля 2015 г."
+      #   Time.now.human_date(:short)      #=> "30/04/2015"
       def human_date(type = :full)
         ::StTools::Human.format_time(self, :date, type)
       end
 
+      # Метод переводит Time в строку на русском или иных языках. Предварительно необходимо вызвать
+      # StTools.setup(:ru или :en).
+      #
+      # @param [Time] time исходное время
+      # @param [Sym] type форма в которой возращать результат: длинная ("10:34:52") или короткая ("10:34")
+      # @option :full длинна форма
+      # @option :short короткая форма
+      # @return [String] строка с форматированным временем
+      # @example Примеры использования
+      #   StTools::Setup.setup(:ru)
+      #   Time.now.human_time(:full)       #=> "08:54:34"
+      #   Time.now.human_time(:short)      #=> "08:55"
       def human_time(type = :full)
         ::StTools::Human.format_time(self, :time, type)
       end
 
+      # Метод переводит DateTime в строку на русском или иных языках. Предварительно необходимо вызвать
+      # StTools.setup(:ru или :en).
+      #
+      # @param [DateTime] time исходные время и дата
+      # @param [Sym] type форма в которой возращать результат: длинная ("28 апреля 2015 г. 10:34:52") или короткая ("28/04/2015 10:34")
+      # @option :full длинна форма
+      # @option :short короткая форма
+      # @return [String] строка с форматированными датой и временем
+      # @example Примеры использования
+      #   StTools::Setup.setup(:ru)
+      #   Time.now.human_datetime(:full)       #=> "30 апреля 2015 г. 08:54:34"
+      #   Time.now.human_datetime(:short)      #=> "30/04/2015 08:55"
       def human_datetime(type = :full)
         ::StTools::Human.format_time(self, :full, type)
       end
 
+      # Метод переводит DateTime в строку на русском или иных языках вида "4 дня 23 часа назад".
+      # Предварительно необходимо вызвать StTools.setup(:ru или :en).
+      #
+      # @param [DateTime] time время и дата
+      # @param [Boolean] ago true, если надо добавить слово "назад" в конец строки
+      # @return [String] строка вида "3 дня 12 часов" или "3 дня 12 часов назад"
+      # @example Примеры использования
+      #   StTools::Setup.setup(:ru)
+      #   (Time.now - 23).human_ago                 #=> "23 секунды назад"
+      #   (Time.now - 24553).human_ago(false)       #=> 6 часов 49 минут"
+      #   Time.now.human_ago                        #=> "сейчас"
       def human_ago(ago = true)
-        ::StTools::Human.ago_in_words(self, ago)
+        ::StTools::Human.human_ago(self, ago)
       end
 
     end

data/lib/socr/geo.yml

@@ -0,0 +1,13 @@
+startend:
+- город
+- район
+- проспект
+- проезд
+- бульвар
+- деревня
+- станция
+- станица
+- санкт-петербург
+synonyms:
+  мкрн: 'микрорайон'
+  мкр: 'микрорайон'

data/lib/st_tools/human.rb

@@ -68,10 +68,10 @@ module StTools
     # @return [String] строка вида "3 дня 12 часов" или "3 дня 12 часов назад"
     # @example Примеры использования
     #   StTools::Setup.setup(:ru)
-    #   StTools::Human.ago_in_words(Time.now - 23, true)       #=> "23 секунды назад"
-    #   StTools::Human.ago_in_words(Time.now - 24553, false)   #=> 6 часов 49 минут"
-    #   StTools::Human.ago_in_words(Time.now)                  #=> "сейчас"
-    def self.ago_in_words(time, ago = true)
+    #   StTools::Human.human_ago(Time.now - 23, true)       #=> "23 секунды назад"
+    #   StTools::Human.human_ago(Time.now - 24553, false)   #=> 6 часов 49 минут"
+    #   StTools::Human.human_ago(Time.now)                  #=> "сейчас"
+    def self.human_ago(time, ago = true)
       now = self.to_time(Time.now.strftime('%Y-%m-%d %H:%M:%S UTC'))
       slf = self.to_time(time.strftime('%Y-%m-%d %H:%M:%S UTC'))
       secs = (now - slf).to_i
@@ -83,6 +83,27 @@ module StTools
       pair.join(' ')
     end
 
+    # Метод принимает параметр - количество секунд между двумя любыми событиями в секундах,
+    # и переводит их в строку на русском или иных языках вида "4 дня 23 часа назад".
+    # Предварительно необходимо вызвать StTools.setup(:ru или :en).
+    #
+    # @param [DateTime] sesc количество секунд
+    # @param [Boolean] ago true, если надо добавить слово "назад" в конец строки
+    # @return [String] строка вида "3 дня 12 часов" или "3 дня 12 часов назад"
+    # @example Примеры использования
+    #   StTools::Setup.setup(:ru)
+    #   StTools::Human.seconds_ago(23, true)       #=> "23 секунды назад"
+    #   StTools::Human.seconds_ago(24553, false)   #=> 6 часов 49 минут"
+    #   StTools::Human.seconds_ago(0)              #=> "сейчас"
+    def self.seconds_ago(secs, ago = true)
+      secs_i = secs.to_i
+      return I18n.t('common.ago.just_now') if secs_i > -1 && secs_i < 1
+      return '' if secs_i <= -1
+      pair = self.ago_in_words_pair(secs_i)
+      pair << I18n.t("common.ago.ago_word") if ago == true
+      pair.join(' ')
+    end
+
     # Метод переводит DateTime в строку на русском или иных языках. Предварительно необходимо вызвать
     # StTools.setup(:ru или :en).
     #

data/lib/st_tools/tokenizer.rb

@@ -0,0 +1,107 @@
+module StTools
+  class Tokenizer
+    attr_reader :input, :result
+
+
+    private
+
+
+    def initialize(opts ={})
+      load_socr(opts[:socr])
+
+      init_class('')
+    end
+
+    def processing(input)
+      init_class(input)
+    end
+
+
+
+
+
+    def load_socr(socr)
+      if socr.nil?
+        @@socr = nil
+        return nil
+      end
+
+      if socr.class == Symbol
+        dict = ::YAML.load_file(__dir__ + "/../socr/#{socr.to_s.downcase}.yml")
+      else
+        dict = socr
+      end
+      dict = Hash[dict.map { |k, v| [k.to_sym, v] }]
+
+      # Валидация списка сокращений
+      raise "ОШИБКА: словарь сокращений не имеет секции :startend" if dict[:startend].nil?
+      raise "ОШИБКА: словарь сокращений не имеет секции :synonyms" if dict[:synonyms].nil?
+
+      @@socr = dict
+    end
+
+    def socr_part_processing(voc, words)
+      if words[0].nil? == false && words[1].nil?
+        return words.shift
+      end
+      return '' if words[0].nil?
+
+      voc.each do |etalon|
+        if etalon.match(/^#{words[0]}/) && etalon.match(/#{words[1]}$/)
+          words.shift
+          words.shift
+          return etalon
+        end
+      end
+      words.shift
+    end
+
+    def socr_one_processing(word)
+      out = Array.new
+      arr = word.split(/[\-\/]/)
+      voc = @@socr[:startend]
+
+      count = arr.count
+      0.upto(count) do
+        out << socr_part_processing(voc, arr)
+      end
+
+      out.count == 0 ? arr : out
+    end
+
+    def socr_synonyms_processing(word)
+      @@socr[:synonyms][word] || word
+    end
+
+    def socr_processing(arr)
+      if @@socr.nil?
+        arr = arr.join(' ').gsub(/\-/, ' ').split(/\s/)
+      else
+        out = Array.new
+        arr.each do |word|
+          if word.match(/[\-\/]/)
+            out += socr_one_processing(word)
+          else
+            out << socr_synonyms_processing(word)
+          end
+        end
+        arr = out
+      end
+      return arr
+    end
+
+    def init_class(input)
+      @input = input
+      @tokens = Array.new
+
+      tmp = StTools::String.normalize(input).gsub(/\-\s{1,100}/, '-').gsub(/\s{1,100}\-/, '-')
+                .gsub(/\/\s{1,100}/, '/').gsub(/\s{1,100}\//, '/')
+      tmp = tmp.split(/[\s\,\.\_\(\)]/)
+      tmp = socr_processing(tmp)
+      tmp.delete_if { |x| x == '' }
+
+      @result = tmp
+    end
+
+  end
+end

data/lib/st_tools/version.rb

@@ -1,3 +1,3 @@
 module StTools
-  VERSION = '0.3.3'
+  VERSION = '0.3.4'
 end

data/lib/st_tools.rb

@@ -3,6 +3,7 @@ $LOAD_PATH.unshift File.join(__dir__, *%w[.. lib])
 require "st_tools/version"
 
 require 'ruby-progressbar'
+require 'yaml'
 
 module StTools
   require 'st_tools/common'

data/test/human_lib_spec.rb

@@ -31,20 +31,34 @@ describe 'Проверка методов StTools::Human.*' do
     expect(test).to include('байт')
   end
 
-  it '.ago_in_words (:ru)' do
+  it '.human_ago (:ru)' do
     ::StTools::Setup.setup(:ru)
-    test = ::StTools::Human.ago_in_words(DateTime.new(2001,2,3,4,5,6,'+7'), true)
+    test = ::StTools::Human.human_ago(DateTime.new(2001,2,3,4,5,6,'+7'), true)
     expect(test).to include('назад')
     expect(test).to include('лет')
   end
 
-  it '.ago_in_words (:en)' do
+  it '.human_ago (:en)' do
     ::StTools::Setup.setup(:en)
-    test = ::StTools::Human.ago_in_words(DateTime.new(2001,2,3,4,5,6,'+7'), true)
+    test = ::StTools::Human.human_ago(DateTime.new(2001,2,3,4,5,6,'+7'), true)
     expect(test).to include('ago')
     expect(test).to include('years')
   end
 
+  it '.seconds_ago (:ru)' do
+    ::StTools::Setup.setup(:ru)
+    test = ::StTools::Human.seconds_ago(67, true)
+    expect(test).to include('назад')
+    expect(test).to include('1 минута')
+  end
+
+  it '.seconds_ago (:en)' do
+    ::StTools::Setup.setup(:en)
+    test = ::StTools::Human.seconds_ago(67, true)
+    expect(test).to include('ago')
+    expect(test).to include('1 minute')
+  end
+
   it '.format_time (:ru)' do
     ::StTools::Setup.setup(:ru)
     test = ::StTools::Human.format_time(Time.now, :full, :full)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: st_tools
 version: !ruby/object:Gem::Version
-  version: 0.3.3
+  version: 0.3.4
 platform: ruby
 authors:
 - Stan Zhuravlev
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2015-04-30 00:00:00.000000000 Z
+date: 2015-05-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -87,6 +87,7 @@ files:
 - lib/modules/integer.rb
 - lib/modules/string.rb
 - lib/modules/time.rb
+- lib/socr/geo.yml
 - lib/st_tools.rb
 - lib/st_tools/common.rb
 - lib/st_tools/fias.rb
@@ -94,6 +95,7 @@ files:
 - lib/st_tools/progress_bar.rb
 - lib/st_tools/string.rb
 - lib/st_tools/system.rb
+- lib/st_tools/tokenizer.rb
 - lib/st_tools/version.rb
 - test/fias_lib_spec.rb
 - test/human_lib_spec.rb