st_tools 0.3.10 → 0.3.11

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 10f93a2349223d5bd2a740ff842b74f9cee2430d
-  data.tar.gz: ae363ce67f9587fde735756bfbbd5b6087afa74c
+  metadata.gz: e3842bbc50514362b84e3a229f04b313aa21c68e
+  data.tar.gz: e43193a68071b6893357ad8aa03081d1280b9952
 SHA512:
-  metadata.gz: 86ba45333dd1dba115edac9cd691c5e14190f49588bf4433719e82f8f4470f12b200bfb86bd81705fe3f3715b6b70f8d45cd71eff9f895a1783dbdbafe69bcc5
-  data.tar.gz: b7ae48dfb3505891d48e1753fd90a6ada5e5829afb12920face31dbd602cb601d031825e7f7e5e3b35927cabf1330f6d7d4d5963d161127534080016c951e9dd
+  metadata.gz: 04754e6087f7fd740302725a6e996817439568da7d7f93920bc21f1e0761522b5c34830c422324567e94bad4a4f181c2d39335147a880669d98c22a466c9f632
+  data.tar.gz: f75bfd06a9143b3110ea550fb06806c6787452b2771043a9a354fefafe4cae0ac77a71b226c83a59bf998f1ff99c475994d0341f94ef50007b10f92f756a95b6

data/README.md

@@ -37,42 +37,42 @@ gem 'st_tools'
 Вы вызываете в любой момент StTools::Human.memory и узнаете текущий размер памяти, занимаемый приложением (процессом)
 
 ```ruby
-StTools.Human.memory               # => 14 кбайт
-StTools.Human.memory               # => 45,3 Мбайт
-StTools.Human.memory               # => 2,6 Гбайт
+StTools::Human.memory               # => 14 кбайт
+StTools::Human.memory               # => 45,3 Мбайт
+StTools::Human.memory               # => 2,6 Гбайт
 ```
 
 Вы вызываете StTools::Human.bytes и перевести любое значение в человеко-удобный вид. Метод можно использовать для показа размера файла
 
 ```ruby
-StTools.Human.bytes(345)           # => 345 байт
-StTools.Human.bytes(14653)         # => 14,5 кбайт
-StTools.Human.bytes(23653763)      # => 23,4 Мбайт
+StTools::Human.bytes(345)           # => 345 байт
+StTools::Human.bytes(14653)         # => 14,5 кбайт
+StTools::Human.bytes(23653763)      # => 23,4 Мбайт
 ```
 
 Вы вызываете StTools::Human.number для перевода любого значения в человеко-удобный вид.
 Метод можно использовать для показа, например, суммы денег
 
 ```ruby
-StTools.Human.number(345)           # => 345
-StTools.Human.number(14653)         # => 14,6 тыс.
-StTools.Human.number(23653763)      # => 23,7 млн.
+StTools::Human.number(345)           # => 345
+StTools::Human.number(14653)         # => 14,6 тыс.
+StTools::Human.number(23653763)      # => 23,7 млн.
 ```
 
 Вы имеете возможность узнать разницу между текущим временем и временем какого-либо события.
 
 ```ruby
 StTools::Setup.setup(:ru)
-StTools.Human.ago_in_words(DateTime.new(2014,12,31), true)        # => 4 месяца 21 день назад
-StTools.Human.ago_in_words(DateTime.new(2013,08,01), false)       # => 1 год 8 месяца
-StTools.Human.ago_in_words(Time.now - 15, true)                   # => 15 секунд назад
+StTools::Human.human_ago(DateTime.new(2014,12,31), true)        # => 4 месяца 21 день назад
+StTools::Human.human_ago(DateTime.new(2013,08,01), false)       # => 1 год 8 месяца
+StTools::Human.human_ago(Time.now - 15, true)                   # => 15 секунд назад
 ```
 
 ```ruby
 StTools::Setup.setup(:en)
-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
+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" в конце фразы.
@@ -86,9 +86,9 @@ StTools.Human.human_ago(Time.now - 15, true)                   # => 15 seconds a
 
 ```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
+StTools::Human.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
 ```
 
 
@@ -96,22 +96,22 @@ StTools.Human.seconds_ago(Time.now - 15, true)                   # => 15 seconds
 
 ```ruby
 StTools::Setup.setup(:ru)
-StTools.Human.format_time(Time.now, :full, :full)              # => 28 апреля 2015 г. 10:45:23
-StTools.Human.format_time(Time.now, :date, :full)              # => 28 апреля 2015 г.
-StTools.Human.format_time(Time.now, :time, :full)              # => 10:45:23
-StTools.Human.format_time(Time.now, :full, :short)             # => 28/04/2015 10:45
-StTools.Human.format_time(Time.now, :date, :short)             # => 28/04/2015
-StTools.Human.format_time(Time.now, :time, :short)             # => 10:45
+StTools::Human.format_time(Time.now, :full, :full)              # => 28 апреля 2015 г. 10:45:23
+StTools::Human.format_time(Time.now, :date, :full)              # => 28 апреля 2015 г.
+StTools::Human.format_time(Time.now, :time, :full)              # => 10:45:23
+StTools::Human.format_time(Time.now, :full, :short)             # => 28/04/2015 10:45
+StTools::Human.format_time(Time.now, :date, :short)             # => 28/04/2015
+StTools::Human.format_time(Time.now, :time, :short)             # => 10:45
 ```
 
 ```ruby
 StTools::Setup.setup(:en)
-StTools.Human.format_time(Time.now, :full, :full)              # => April 28, 2015 09:45:23 am
-StTools.Human.format_time(Time.now, :date, :full)              # => April 28, 2015
-StTools.Human.format_time(Time.now, :time, :full)              # => 09:45:23 am
-StTools.Human.format_time(Time.now, :full, :short)             # => 04/28/2015 09:45 am
-StTools.Human.format_time(Time.now, :date, :short)             # => 04/28/2015
-StTools.Human.format_time(Time.now, :time, :short)             # => 09:45 am
+StTools::Human.format_time(Time.now, :full, :full)              # => April 28, 2015 09:45:23 am
+StTools::Human.format_time(Time.now, :date, :full)              # => April 28, 2015
+StTools::Human.format_time(Time.now, :time, :full)              # => 09:45:23 am
+StTools::Human.format_time(Time.now, :full, :short)             # => 04/28/2015 09:45 am
+StTools::Human.format_time(Time.now, :date, :short)             # => 04/28/2015
+StTools::Human.format_time(Time.now, :time, :short)             # => 09:45 am
 ```
 
 Вы можете подмешать модуль `StTools::Module` в классы String, Integer, Time.
@@ -123,7 +123,7 @@ class String
    include StTools::Module::String
 end
 
-(Time.now - 15).human_ago                         # => 15 секунд назад
+(Time.now - 15)::Human_ago                         # => 15 секунд назад
 Time.now.format_date                              # => 28 апреля 2015 г.
 Time.now.format_date(:short)                      # => 28/04/2015
 ```
@@ -158,12 +158,17 @@ StTools::String.upcase('Москва')                      # => МОСКВА
 #### normalize
 
 Иногда надо нормализовать строку и привести ее к виду, удобному для машинной обработки.
-Метод normalize последовательно делает: strip, delat, downcase
+Метод normalize последовательно делает: `strip`, `delat`, `downcase`. Кроме того, метод корректно заменит
+на обычные пробелы "короткие" пробелы, получающиеся после преобразования тега HTML ` ` в пробел. 
 
 ```ruby
 StTools::String.normalize('   Москва  ')              # => "москва"
 ```
 
+Внимание!!! Функцию следует использовать с осторожностью, и не забывать, что для ряда задач она не подходит. 
+В частности, выполнение `StTools::String.normalize('TRUE')` даст значение `true`, в котором буква `е` будет
+русская (применена функция `delat`). 
+
 #### caps
 
 Следующий метод приводит строку к нижнему регистру, но делает первую букву заглавной.

data/lib/st_tools/fias.rb

@@ -116,6 +116,43 @@ module StTools
       return false
     end
 
+    # Метод расчитывает расстояние в метрах между двумя географическими точками
+    #
+    # @param [Float] from_lat - широта первой точки
+    # @param [Float] from_long - долгота первой точки
+    # @param [Float] to_lat - широта второй точки
+    # @param [Float] to_long - долгота второй точки
+    # @return [Float] расстояние в метрах между двумя точками
+    # @example Примеры использования
+    #   # Москва - Санкт-Петербург
+    #   StTools::Fias.distance(55.75583, 37.61778, 59.95000, 30.31667)    #=> 634 988 м (635 км)
+    #   # Москва - Киев
+    #   StTools::Fias.distance(55.75583, 37.61778, 50.450500, 30.523000)  #=> 755 744 м (756 км)
+    #   # Москва - Пермь
+    #   StTools::Fias.distance(55.75583, 37.61778, 58.01389, 56.24889)    #=> 1 155 328 м (1 155 км)
+    #   # Москва - Сан-Франциско
+    #   StTools::Fias.distance(55.75583, 37.61778, 37.76667, -122.43333)  #=> 9 445 325 м (9 445 км)
+    def self.distance(from_lat, from_long, to_lat, to_long)
+      # coord - координата километровой отметки мкад
+      rad_per_deg = Math::PI/180  # PI / 180
+      rkm = 6371                  # Earth radius in kilometers
+      rm = rkm * 1000             # Radius in meters
+
+      dlat_rad = (to_lat.to_f - from_lat.to_f) * rad_per_deg  # Delta, converted to rad
+      dlon_rad = (to_long.to_f - from_long.to_f) * rad_per_deg
+
+      lat1_rad = from_lat.to_f * rad_per_deg
+      lon1_rad = from_long.to_f * rad_per_deg
+
+      lat2_rad = to_lat * rad_per_deg
+      lon2_rad = to_long * rad_per_deg
+
+      a = Math.sin(dlat_rad/2)**2 + Math.cos(lat1_rad) * Math.cos(lat2_rad) * Math.sin(dlon_rad/2)**2
+      c = 2 * Math::atan2(Math::sqrt(a), Math::sqrt(1-a))
+
+      (rm * c).to_i # Delta in meters
+    end
+
 
     private
 

data/lib/st_tools/string.rb

@@ -73,7 +73,7 @@ module StTools
     #   StTools::String.normalize("  Ёлки-     ПАЛКИ")   #=> "елки- палки"
     def self.normalize(text)
       return nil if text.nil?
-      return self.downcase(self.delat(text)).strip.gsub(/\s{1,100}/, ' ')
+      return self.downcase(self.delat(text)).strip.gsub(/[\s\t\u00A0]{1,100}/, ' ')
     end
 
     # Метод позволяет показывать клиенту строку в неполном объеме, с закрытием части символов в строке звездочкой.

data/lib/st_tools/version.rb

@@ -1,3 +1,3 @@
 module StTools
-  VERSION = '0.3.10'
+  VERSION = '0.3.11'
 end

data/test/fias_lib_spec.rb

@@ -109,4 +109,34 @@ describe 'Проверка методов StTool::Fias.*' do
     test = ::StTools::Fias.federal?('0c5b2444-70a0-4932-980c-b4dc053f02b5')
     expect(test).to eq false
   end
+
+  #--------------------------------------------------------
+  #
+  # Тесты расчета расстояния между точками
+  #
+  #--------------------------------------------------------
+  it 'Москва - Санкт-Петербург' do
+    test = ::StTools::Fias.distance(55.75583, 37.61778, 59.95000, 30.31667)
+    expect(test).to be > 634000
+    expect(test).to be < 635000
+  end
+
+  it 'Москва - Киев' do
+    test = ::StTools::Fias.distance(55.75583, 37.61778, 50.450500, 30.523000)
+    expect(test).to be > 755000
+    expect(test).to be < 757000
+  end
+
+  it 'Москва - Пермь' do
+    test = ::StTools::Fias.distance(55.75583, 37.61778, 58.01389, 56.24889)
+    expect(test).to be > 1150000
+    expect(test).to be < 1160000
+  end
+
+  it 'Москва - Сан-Франциско' do
+    test = ::StTools::Fias.distance(55.75583, 37.61778, 37.76667, -122.43333)
+    expect(test).to be > 9440000
+    expect(test).to be < 9480000
+  end
+
 end

metadata

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