webpage_update_checker 1.3.0 → 1.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f8c2526d9cd437964c3c639911f5f67a47ac66864e6728ca16c5f3369b761bb0
-  data.tar.gz: 18acb4cde3a66373d7ddea4b1175d89b696ca52dc08be62e39a327f535dcdb79
+  metadata.gz: b97df2904819fb7a9fc893107b6d9171a19584a079b7803166d6c2f20737f27e
+  data.tar.gz: ba5c7ef8f48c562bbdf80f2d6980b5afa4600fddc0eb9ae0c7ee94c2ed0f6143
 SHA512:
-  metadata.gz: 261c561477dce557e7ea8dcb849ef598040dafa37533dd5ec9a48a77c9ea9039b92adce9cc6cc18429fde9d1b567e8424be76556ad50a820d08209704bdd049b
-  data.tar.gz: eb0d9b21d0ec08687c1eb3b66944569ca01c146bbb26cab94352f5569195fd46c7fb037971078f79ce471d05bd5c0242553a3e619b962dc0b80ecf1c658d9c37
+  metadata.gz: 72d8c90dd835fdf796c9cf40e89acd4fb2e63b827f3b7eadfbab08cd8c337118063513b13a41e468aa467c9da39aca2ee03ac56dfd98d985a6580f0ff85688ec
+  data.tar.gz: 1a220e97a26cd354401c41cf8c74f0926222fbf4ad7894f5386f534628a7a9d523c077eca9dd209bd1beb7d7adb4b6f68bc618926d79cb0fee793795fbceafc0

data/Gemfile.lock

@@ -1,13 +1,19 @@
 PATH
   remote: .
   specs:
-    webpage_update_checker (1.3.0)
+    webpage_update_checker (1.4.0)
+      activesupport
       mechanize
 
 GEM
   remote: https://rubygems.org/
   specs:
     abstract_type (0.0.7)
+    activesupport (5.2.1)
+      concurrent-ruby (~> 1.0, >= 1.0.2)
+      i18n (>= 0.7, < 2)
+      minitest (~> 5.1)
+      tzinfo (~> 1.1)
     adamantium (0.2.0)
       ice_nine (~> 0.11.0)
       memoizable (~> 0.4.0)
@@ -23,6 +29,7 @@ GEM
     concord (0.1.5)
       adamantium (~> 0.2.0)
       equalizer (~> 0.0.9)
+    concurrent-ruby (1.1.3)
     connection_pool (2.2.2)
     coveralls (0.8.19)
       json (>= 1.8, < 3)
@@ -42,6 +49,8 @@ GEM
     hashdiff (0.3.7)
     http-cookie (1.0.3)
       domain_name (~> 0.5)
+    i18n (1.1.1)
+      concurrent-ruby (~> 1.0)
     ice_nine (0.11.2)
     jaro_winkler (1.5.1)
     json (2.1.0)
@@ -61,10 +70,11 @@ GEM
       mime-types-data (~> 3.2015)
     mime-types-data (3.2018.0812)
     mini_portile2 (2.3.0)
+    minitest (5.11.3)
     net-http-digest_auth (1.4.1)
     net-http-persistent (3.0.0)
       connection_pool (~> 2.2)
-    nokogiri (1.8.4)
+    nokogiri (1.8.5)
       mini_portile2 (~> 2.3.0)
     ntlm-http (0.1.1)
     parallel (1.12.1)
@@ -129,6 +139,8 @@ GEM
     thor (0.19.4)
     thread_safe (0.3.6)
     tins (1.19.0)
+    tzinfo (1.2.5)
+      thread_safe (~> 0.1)
     unf (0.1.4)
       unf_ext
     unf_ext (0.0.7.5)

data/README.md

@@ -6,10 +6,14 @@
 [![CircleCI](https://circleci.com/gh/corselia/webpage-update-checker.svg?style=svg)](https://circleci.com/gh/corselia/webpage-update-checker)
 
 # Usage
+
+## Install gem
 ```
 $ vim Gemfile
+
 # Add a line
 # gem 'webpage_update_checker'
+
 $ bundle install
 ```
 
@@ -19,23 +23,68 @@ or
 $ gem install webpage_update_checker
 ```
 
+## Write your app
+
+### Obtain by MD5
 ```ruby
 require 'webpage_update_checker'
 
 checker = WebpageUpdateChecker::Client.new
-target_page_md5 = WebpageUpdateChecker::Methods::Md5.new(uri: 'http://www.ne.jp/asahi/pursuits/ootsuki/pc/X68k/x680x0.xhtml')
 
+target_page_md5 = WebpageUpdateChecker::Methods::Md5.new(uri: 'http://www.ne.jp/asahi/pursuits/ootsuki/pc/X68k/x680x0.xhtml')
 checker.current_comparison_value(target_page_md5) #=> fb2eeb524e6b5637ef7fa4bed48f1d67
-checker.updated?(target_page_md5, previous_comparison_value: 'fb2eeb524e6b5637ef7fa4bed48f1d67') #=> false (not updated)
-checker.updated?(target_page_md5, previous_comparison_value: '12345678901234567890123456789012') #=> true (updated)
+```
+
+### Obtain Last-Modified
+```ruby
+require 'webpage_update_checker'
+
+checker = WebpageUpdateChecker::Client.new
 
 target_page_last_modified = WebpageUpdateChecker::Methods::LastModified.new(uri: 'http://www.ne.jp/asahi/pursuits/ootsuki/pc/X68k/x680x0.xhtml')
 checker.current_comparison_value(target_page_last_modified) #=> 2008-03-17 16:05:01 +0000
+```
+
+### Obtain HTTP Status Code
+```ruby
+require 'webpage_update_checker'
+
+checker = WebpageUpdateChecker::Client.new
 
 target_page_http_status_code = WebpageUpdateChecker::Methods::HttpStatusCode.new(uri: 'http://www.ne.jp/asahi/pursuits/ootsuki/pc/X68k/x680x0.xhtml')
 checker.current_comparison_value(target_page_http_status_code) #=> 200
 ```
 
+### Compare by MD5
+```ruby
+require 'webpage_update_checker'
+
+checker = WebpageUpdateChecker::Client.new
+
+target_page_md5 = WebpageUpdateChecker::Methods::Md5.new(uri: 'http://www.ne.jp/asahi/pursuits/ootsuki/pc/X68k/x680x0.xhtml')
+
+checker.current_comparison_value(target_page_md5) #=> fb2eeb524e6b5637ef7fa4bed48f1d67
+checker.updated?(target_page_md5, previous_comparison_value: 'fb2eeb524e6b5637ef7fa4bed48f1d67') #=> false (not updated)
+checker.updated?(target_page_md5, previous_comparison_value: '12345678901234567890123456789012') #=> true (updated)
+```
+
+### Compare by Last-Modified with Lazy Time
+- `Lazy Time` comparision means to compare by not accurate datetime but ABOUT datetime
+- For example, when latest `Last-Modified` is `2008-03-18 01:05:01 +0000` and `lazy_seconds` is set as '60 * 5', if now getting `Last-Modified` is `2008-03-18 01:07:01 +0000` it does NOT regard as 'Updated'
+    - if now getting `Last-Modified` is `2008-03-18 01:08:02 +0000` it DOES regard as 'Updated'
+
+```ruby
+require 'webpage_update_checker'
+
+checker = WebpageUpdateChecker::Client.new
+
+current_time_object = WebpageUpdateChecker::Methods::LastModified.new(uri: 'http://www.ne.jp/asahi/pursuits/ootsuki/pc/X68k/x680x0.xhtml')
+previous_comparision_value = '2008-03-18 01:00:01 +0900'
+lazy_seconds = 60 * 5
+
+checker.lazy_time_updated?(current_time_object, previous_comparison_value: previous_comparision_value, lazy_seconds: lazy_seconds) #=> false
+```
+
 # Methods
 You can use these `Methods`.
 
@@ -52,6 +101,8 @@ You can use these methods in each `Methods`.
 
 - `#updated?(checked_object, previous_comparison_value:)`
     - `#=> true or false`
+- `#lazy_time_updated?(checked_object, previous_comparison_value:, lazy_seconds:)`
+    - `#=> true or false`
 - `#current_comparison_value(checked_object)`
     - `#=> object such as Time (LastModified), String (MD5, SHA512...) or Integer (HTTP status code)`
 

data/lib/webpage_update_checker/client.rb

@@ -1,4 +1,6 @@
 require 'mechanize'
+require 'active_support'
+require 'active_support/core_ext'
 Dir[File.expand_path('methods', __dir__) << '/*.rb'].each { |file| require file }
 
 module WebpageUpdateChecker
@@ -12,6 +14,13 @@ module WebpageUpdateChecker
       end
     end
 
+    def lazy_time_updated?(checked_object, previous_comparison_value:, lazy_seconds:)
+      corrected_previous_comparison_value_time_class = (Time.parse(previous_comparison_value) + lazy_seconds.seconds).utc
+      checked_object_time_class = current_comparison_value(checked_object).utc
+
+      checked_object_time_class > corrected_previous_comparison_value_time_class
+    end
+
     def current_comparison_value(checked_object)
       checked_object.current_comparison_value
     end

data/lib/webpage_update_checker/methods/last_modified.rb

@@ -8,6 +8,7 @@ module WebpageUpdateChecker
         @uri = uri
       end
 
+      # Return Time class object
       def current_comparison_value
         page = Mechanize.new.get(@uri)
         page.header['last-modified'] ? Time.parse(page.header['last-modified']) : nil

data/lib/webpage_update_checker/version.rb

@@ -1,3 +1,3 @@
 module WebpageUpdateChecker
-  VERSION = '1.3.0'.freeze
+  VERSION = '1.4.0'.freeze
 end

data/webpage_update_checker.gemspec

@@ -22,6 +22,7 @@ Gem::Specification.new do |spec|
   spec.require_paths = ['lib']
 
   spec.add_dependency 'mechanize'
+  spec.add_dependency 'activesupport'
 
   spec.add_development_dependency 'bundler', '~> 1.16'
   spec.add_development_dependency 'codeclimate-test-reporter', '~> 1.0.0'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: webpage_update_checker
 version: !ruby/object:Gem::Version
-  version: 1.3.0
+  version: 1.4.0
 platform: ruby
 authors:
 - Osamu Takiya
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2018-11-25 00:00:00.000000000 Z
+date: 2018-11-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: mechanize
@@ -24,6 +24,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement