iso8601 0.12.0 → 0.12.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2cc31f1efb3e05bf8a044ee03aabbfbbda87a2e050b503cebb673764dc9207f1
-  data.tar.gz: 85f1a4acb0b3ed87753b6a0100847d69f6d5edb587c46f63fc67affd1f6b0559
+  metadata.gz: b275dd85921d3d5a18dd4cbecaeb2f7a7c5c76e2527030087e00d971c2fb2ba8
+  data.tar.gz: 2ad804505434c8fd15e52298915cf191b1a6d5529c069a65cb418bb3f92b9719
 SHA512:
-  metadata.gz: 2489374d7371e548d808875c7274bb9dfa4645b8754663b0ee11b1d8a74e7e93aaaf0c91954313b5a5d5dba3173e24cf70e819d8d02b3fc0624c53f89b926d5b
-  data.tar.gz: f342d126be742e40464172577bf3bcac8093deba1150b6bf890ce2eeec444eed4946b139626ca8a8b5af57bdb31b88d70f706abf2451f49113b6d7cd15e83bda
+  metadata.gz: 88d158b64e8e9958b69263593a7606000d50dc254fb1ef929a0544ed4d2881ebea16b37aa5638082a866a148d2aab28c7ab2680703e05f8a480deb44590e9f8b
+  data.tar.gz: 15591902cd2de0debe9b4b1c2f8c2a4568ff9fdaf35372d88183d5f8a81a3f245c6ac3b871e5dda621b0b75674f6f8b494e55581f93fa476f5e2cd8a7adb3abd

data/iso8601.gemspec

@@ -17,49 +17,11 @@ Gem::Specification.new do |s|
   DESC
   s.license = 'MIT'
   s.rubyforge_project = 'iso8601'
-  s.files = %w[CHANGELOG.md
-               CONTRIBUTING.md
-               Gemfile
-               LICENSE
-               README.md
-               Rakefile
-               iso8601.gemspec
-               docs/date-time.md
-               docs/duration.md
-               docs/time-interval.md
-               lib/iso8601.rb
-               lib/iso8601/atomic.rb
-               lib/iso8601/date.rb
-               lib/iso8601/date_time.rb
-               lib/iso8601/days.rb
-               lib/iso8601/duration.rb
-               lib/iso8601/errors.rb
-               lib/iso8601/hours.rb
-               lib/iso8601/minutes.rb
-               lib/iso8601/months.rb
-               lib/iso8601/seconds.rb
-               lib/iso8601/time.rb
-               lib/iso8601/time_interval.rb
-               lib/iso8601/version.rb
-               lib/iso8601/weeks.rb
-               lib/iso8601/years.rb
-               spec/iso8601/date_spec.rb
-               spec/iso8601/date_time_spec.rb
-               spec/iso8601/days_spec.rb
-               spec/iso8601/duration_spec.rb
-               spec/iso8601/hours_spec.rb
-               spec/iso8601/minutes_spec.rb
-               spec/iso8601/months_spec.rb
-               spec/iso8601/seconds_spec.rb
-               spec/iso8601/time_interval_spec.rb
-               spec/iso8601/time_spec.rb
-               spec/iso8601/weeks_spec.rb
-               spec/iso8601/years_spec.rb
-               spec/spec_helper.rb]
-  s.test_files = s.files.grep(%r{^spec/})
+  s.files =  %w{LICENSE README.md CONTRIBUTING.md} + `git ls-files`.split("\n").select { |f| f =~ %r{^(?:lib/)}i }
+  s.test_files = %w{Rakefile iso8601.gemspec Gemfile} + `git ls-files`.split("\n").select { |f| f =~ %r{^(?:specs/)}i }
   s.require_paths = ['lib']
 
-  s.has_rdoc = 'yard'
+  s.metadata["yard.run"] = "yri"
   s.required_ruby_version = '>= 2.0.0'
   s.add_development_dependency 'rspec', '~> 3.6'
   s.add_development_dependency 'rubocop', '~> 0.50'

data/lib/iso8601/version.rb

@@ -1,5 +1,5 @@
 module ISO8601
   ##
   # The gem version
-  VERSION = '0.12.0'.freeze
+  VERSION = '0.12.1'.freeze
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: iso8601
 version: !ruby/object:Gem::Version
-  version: 0.12.0
+  version: 0.12.1
 platform: ruby
 authors:
 - Arnau Siches
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-07-28 00:00:00.000000000 Z
+date: 2018-10-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
@@ -75,15 +75,11 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- CHANGELOG.md
 - CONTRIBUTING.md
 - Gemfile
 - LICENSE
 - README.md
 - Rakefile
-- docs/date-time.md
-- docs/duration.md
-- docs/time-interval.md
 - iso8601.gemspec
 - lib/iso8601.rb
 - lib/iso8601/atomic.rb
@@ -101,23 +97,11 @@ files:
 - lib/iso8601/version.rb
 - lib/iso8601/weeks.rb
 - lib/iso8601/years.rb
-- spec/iso8601/date_spec.rb
-- spec/iso8601/date_time_spec.rb
-- spec/iso8601/days_spec.rb
-- spec/iso8601/duration_spec.rb
-- spec/iso8601/hours_spec.rb
-- spec/iso8601/minutes_spec.rb
-- spec/iso8601/months_spec.rb
-- spec/iso8601/seconds_spec.rb
-- spec/iso8601/time_interval_spec.rb
-- spec/iso8601/time_spec.rb
-- spec/iso8601/weeks_spec.rb
-- spec/iso8601/years_spec.rb
-- spec/spec_helper.rb
 homepage: https://github.com/arnau/ISO8601
 licenses:
 - MIT
-metadata: {}
+metadata:
+  yard.run: yri
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -134,21 +118,11 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: iso8601
-rubygems_version: 2.7.6
+rubygems_version: 2.7.7
 signing_key: 
 specification_version: 4
 summary: Ruby parser to work with ISO 8601 dateTimes and durations - http://en.wikipedia.org/wiki/ISO_8601
 test_files:
-- spec/iso8601/date_spec.rb
-- spec/iso8601/date_time_spec.rb
-- spec/iso8601/days_spec.rb
-- spec/iso8601/duration_spec.rb
-- spec/iso8601/hours_spec.rb
-- spec/iso8601/minutes_spec.rb
-- spec/iso8601/months_spec.rb
-- spec/iso8601/seconds_spec.rb
-- spec/iso8601/time_interval_spec.rb
-- spec/iso8601/time_spec.rb
-- spec/iso8601/weeks_spec.rb
-- spec/iso8601/years_spec.rb
-- spec/spec_helper.rb
+- Rakefile
+- iso8601.gemspec
+- Gemfile

data/CHANGELOG.md

@@ -1,114 +0,0 @@
-## 0.12.0
-
-* Fix `Months#to_seconds` from November (thanks @walterbrebels).
-
-## 0.11.0
-
-* Add support for unary minus operator (thanks @walterbrebels).
-
-## 0.10.1
-
-* Fix `TimeInterval` size for non UTC timezones. (#41)
-
-## 0.10.0
-
-* Fix `TimeInterval` with `<duration>/<end>` patterns and leap years.
-* Fix decimal fractions on date atoms. **WARNING** some duration patterns are
-  no longer valid.
-
-## 0.9.1
-
-* Fix `Duration#to_pattern` for negative durations based on a `Numeric` (thanks @figwit).
-
-## 0.9.0
-
-This version is **not compatible** with previous versions.  Atoms and Durations
-changed their interface when treating base dates so it is only applied when
-computing the Atom length (e.g. `#to_seconds`).  As a consequence, it is no
-longer possible to do operations like `DateTime + Duration`.
-
-* Add time intervals (thanks @Angelmmiguel).
-* Remove `Duration#to_i`.
-* Change `Duration#to_seconds` to accept a base `DateTime`.
-* Remove duration dependency on a base date on the instance level.
-* Change `Years#to_seconds` and `Months#to_seconds` to accept a base `DateTime`.
-* Remove atom dependency on a base date on the instance level.
-* Add `Atomic` mixin.
-* Remove `Atom` abstract class.
-* Allow `ISO8601::Duration` to perform operations with `Numeric` (thanks @Angelmmiguel).
-
-## 0.8.7
-
-* Make `Atom` comparable with the same kind (thanks @glassbead0).
-* Fix #18 document interfaces to core date/time classes.
-
-## 0.8.6
-
-* Fix #26 operations with Date, DateTime and Time with Duration (e.g. `ISO8601::DateTime.new('2012-07-07T20:20:20Z') - ISO8601::Duration.new('PT10M')`).
-* Fix #25 accept time components with timezone and only hour component (e.g. `ISO8601::Time.new('T10+01:00')`).
-* Fix Docker image for testing and inspecting.
-
-## 0.8.5
-
-* Fix `DateTime#hash`
-* Fix `DateTime#second` and `Time#second` precision.  Now it's rounded to the
-first decimal.
-
-## 0.8.4
-
-* Remove unwanted log.
-
-## 0.8.3
-
-* Fix partial time patterns with timezone: `PThh:mmZ`, `PThhZ`.
-
-## 0.8.2
-
-* Fix time components using comma (,) as a decimal separator.
-
-## 0.8.1
-
-* Fix durations using comma (,) as a decimal separator.
-
-## 0.8.0
-
-* `DateTime` has hash identity by value.
-* `Time` has hash identity by value.
-* `Date` has hash identity by value.
-* `Duration` has hash identity by value.
-* `Atom` has hash identity by value.
-* `Atom#value` returns either an integer or a float.
-* `Atom#to_s` returns a valid ISO8601 subpattern.
-
-## 0.7.0
-
-* Add decimal fractions for any component in a duration.
-* Add a catch all `ISO8601::Errors::StandardError`.
-* Add support for comma (`,`) as a separator for duration decimal fractions.
-
-## 0.6.0
-
-* Add `#hash` to `Duration`, `Date`, `Time` and `DateTime`.
-
-## 0.5.2
-
-* Fix `DateTime` when handling empty strings.
-
-## 0.5.1
-
-* Fix durations with sign.
-
-## 0.5.0
-
-* Drop support for Ruby 1.8.7.
-* Add support for Rubinius 2.
-* `ISO8601::DateTime#century` no longer exists. Truncated representations were
-removed in ISO 8601:2004.
-* `ISO8601::DateTime#zone` delegates to core `DateTime#zone`.
-* `ISO8601::DateTime#timezone` no longer exists. Now it delegates to
-`DateTime#zone`.
-* A date can have sign: `-1000-01-01`, `+2014-05-06T10:11:12Z`.
-* A date time can be converted to an array of atoms with `#to_a`.
-* Ordinal dates supported.
-* A date component is represented by `ISO8601::Date`.
-* Week date pattern (YYYY-Wdww, YYYY-Www-D).

data/docs/date-time.md

@@ -1,86 +0,0 @@
-# Date Time, Date, Time
-
-
-## Interface with core classes
-
-ISO8601 classes provide a method `to_*` to convert to its core equivalent:
-
-```ruby
-ISO8601::DateTime#to_datetime # => #<DateTime: ...>
-ISO8601::Date#to_date # => #<Date: ...>
-ISO8601::Time#to_time # => #<Time: ...>
-```
-
-## Differences with core Date, Time and DateTime
-
-### Reduced precision
-
-Core `Date.parse` and `DateTime.parse` don't allow reduced precision. For
-example:
-
-```ruby
-DateTime.parse('2014-05') # => ArgumentError: invalid date
-```
-
-But the standard covers this situation assuming any missing token as its lower
-value:
-
-```ruby
-ISO8601::DateTime.new('2014-05').to_s # => "2014-05-01T00:00:00+00:00"
-ISO8601::DateTime.new('2014').to_s # => "2014-01-01T00:00:00+00:00"
-```
-
-The same assumption happens in core classes with `.new`:
-
-```ruby
-DateTime.new(2014,5) # => #<DateTime: 2014-05-01T00:00:00+00:00 ((2456779j,0s,0n),+0s,2299161j)>
-DateTime.new(2014) # => #<DateTime: 2014-01-01T00:00:00+00:00 ((2456659j,0s,0n),+0s,2299161j)>
-```
-
-### Unmatched precision
-
-Unmatched precison is handled strongly. Notice the time fragment is lost in
-`DateTime.parse` with no warning only if the loose precision is in the time
-component.
-
-```ruby
-ISO8601::DateTime.new('2014-05-06T101112')  # => ISO8601::Errors::UnknownPattern
-DateTime.parse('2014-05-06T101112')  # => #<DateTime: 2014-05-06T00:00:00+00:00 ((2456784j,0s,0n),+0s,2299161j)>
-
-ISO8601::DateTime.new('20140506T10:11:12')  # => ISO8601::Errors::UnknownPattern
-DateTime.parse('20140506T10:11:12')  # => #<DateTime: 2014-05-06T10:11:12+00:00 ((2456784j,0s,0n),+0s,2299161j)>
-```
-
-### Strong pattern matching
-
-Week dates raise an error when two digit days provied instead of return monday:
-
-```ruby
-ISO8601::DateTime.new('2014-W15-02') # => ISO8601::Errors::UnknownPattern
-DateTime.new('2014-W15-02')  # => #<Date: 2014-04-07 ((2456755j,0s,0n),+0s,2299161j)>
-```
-
-
-## Atomization
-
-`DateTime#to_a` allows decomposing to an array of atoms:
-
-```ruby
-atoms = ISO8601::DateTime.new('2014-05-31T10:11:12Z').to_a # => [2014, 5, 31, 10, 11, 12, '+00:00']
-dt = DateTime.new(*atoms)
-```
-
-## Sign
-
-Ordinal dates keep the sign. `2014-001` is not the same as `-2014-001`.
-
-
-## Fractional seconds precision
-
-Fractional seconds for `ISO8601::DateTime` and `ISO8601::Time` are rounded to
-one decimal.
-
-```ruby
-ISO8601::DateTime.new('2015-02-03T10:11:12.12').second #=> 12.1
-ISO8601::Time.new('T10:11:12.16').second #=> 12.2
-```

data/docs/duration.md

@@ -1,76 +0,0 @@
-# Duration
-
-> Durations are a component of time intervals and define the amount of
-> intervening time in a time interval. Source: [Wikipedia ISO8601](https://en.wikipedia.org/wiki/ISO_8601#Durations)
-
-See [Time Interval](time-interval.md) for working with specific intervals of
-time.
-
-## Supported patterns
-
-```
-PnYnMnDTnHnMnS
-PnW
-```
-
-`P<date>T<time>` will not be implemented.
-
-
-## Usage
-
-Some times using durations might be more convenient than using time intervals:
-
-```ruby
-duration = ISO8601::Duration.new('PT10H')
-duration.to_seconds # => 36000.0
-```
-
-You can reuse the duration with a time interval:
-
-```ruby
-start_time = ISO8601::DateTime.new('2015-01-01T10:11:12Z')
-time_interval = ISO8601::TimeInterval.from_duration(start_time, duration)
-time_interval.size # => 36000.0
-end_time = ISO8601::DateTime.new('2015-01-01T10:11:12Z')
-time_interval = ISO8601::TimeInterval.from_duration(duration, end_time)
-```
-
-Or use an ad-hoc base:
-
-```ruby
-base = ISO8601::DateTime.new('2015-01-01T10:11:12Z')
-duration = ISO8601::Duration.new('PT10H')
-duration.to_seconds(base) # => 36000.0
-```
-
-**Warning**: When using durations without base, the result of `#to_seconds` is
-an _average_.  See the atoms' implementation for details.
-
-
-# Operate with durations
-
-The `ISO8601::Duration` has the concept of sign to be able to represent negative
-values:
-
-```ruby
-(ISO8601::Duration.new('PT10S') - ISO8601::Duration.new('PT12S')).to_s  #=> '-PT2S'
-(ISO8601::Duration.new('-PT10S') + ISO8601::Duration.new('PT12S')).to_s #=> 'PT2S'
-```
-
-You can also inspect a duration by atom:
-
-```
-duration = ISO8601::Duration.new('P2Y1MT2H')
-duration.years   # => #<ISO8601::Years ... @atom=2.0>
-duration.months  # => #<ISO8601::Months ... @atom=1.0>
-duration.days    # => #<ISO8601::Days ... @atom=0>
-duration.hours   # => #<ISO8601::Hours ... @atom=2.0>
-duration.minutes # => #<ISO8601::Hours ... @atom=0.0>
-duration.seconds # => #<ISO8601::Hours ... @atom=0.0>
-```
-
-Or get back the pattern:
-
-```ruby
-duration.to_s # => 'P2Y1MT2H'
-```

data/docs/time-interval.md

@@ -1,120 +0,0 @@
-# Time Interval
-
-> A time interval is the intervening time between two time points.
-Source: [Wikipedia ISO8601](https://en.wikipedia.org/wiki/ISO_8601#Time_intervals)
-
-This library implements the Time Interval type via [`ISO8601::TimeInterval`](../lib/iso8601/time_interval.rb)
-with the following constructors:
-
-* `TimeInterval.new(String)` (or `TimeInterval.parse(String)`)
-* `TimeInterval.from_duration(Duration, Hash<DateTime>)`
-* `TimeInterval.from_datetime(DateTime, DateTime)`
-
-
-## Supported patterns
-
-```
-<start>/<end>
-<start>/<duration>
-<duration>/<end>
-```
-
-Where `<start>` and `<end>` are points in time and `<duration>` is an amount of
-time.
-
-The pattern `<duration>` is not implemented; instead, you can use
-[`TimeInterval.from_duration`](../lib/iso8601/time_interval.rb#L70).
-
-
-## Usage
-
-### `<start>/<end>`
-
-The resulting time interval will have a starting point based on the provided
-`<start>` pattern and an ending point based on the provided `<end>` pattern.
-
-```ruby
-ti = ISO8601::TimeInterval.parse('2015-12-12T19:53:00Z/2015-12-13T19:53:00Z')
-ti.start_time.to_s  # => '2015-12-12T19:53:00Z'
-ti.end_time.to_s    # => '2015-12-13T19:53:00Z'
-ti.size             # => 86_400.0
-```
-
-### `<start>/<duration>`
-
-The resulting time interval will have a starting point based on the provided
-`<start>` pattern and an ending point result of `<start> + <duration>`.
-
-```ruby
-ti = ISO8601::TimeInterval.parse('2015-12-12T19:53:00Z/P1D')
-ti.start_time.to_s  # => '2015-12-12T19:53:00Z'
-ti.end_time.to_s    # => '2015-12-13T19:53:00Z'
-ti.size             # => 86_400.0
-```
-
-### `<duration>/<end>`
-
-The resulting time interval will have a starting point result of
-`<end> - <duration>` and an ending point based on the provided `<end>` pattern.
-
-```ruby
-ti = ISO8601::TimeInterval.parse('P1D/2015-12-13T19:53:00Z')
-ti.start_time.to_s  # => '2015-12-12T19:53:00Z'
-ti.end_time.to_s    # => '2015-12-13T19:53:00Z'
-ti.size             # => 86_400.0
-```
-
-
-### `TimeInterval.from_duration`
-
-```ruby
-duration = ISO8601::Duration.new('P1D`)
-start_time = ISO8601::DateTime.new('2015-12-12T19:53:00Z')
-ti = ISO8601::TimeInterval.from_duration(start_time, duration)
-ti.start_time.to_s  # => '2015-12-12T19:53:00Z'
-ti.end_time.to_s    # => '2015-12-13T19:53:00Z'
-ti.size             # => 86_400.0
-
-
-end_time = ISO8601::DateTime.new('2015-12-13T19:53:00Z')
-ti2 = ISO8601::TimeInterval.from_duration(duration, end_time)
-ti2.start_time.to_s  # => '2015-12-12T19:53:00Z'
-ti2.end_time.to_s    # => '2015-12-13T19:53:00Z'
-ti2.size             # => 86_400.0
-```
-
-### `TimeInterval.from_datetime`
-
-This constructor is an alternative way to `<start>/<end>` via Ruby objects.
-
-```ruby
-start_time = ISO8601::DateTime.new('2015-12-12T19:53:00Z')
-end_time = ISO8601::DateTime.new('2015-12-13T19:53:00Z')
-ti2 = ISO8601::TimeInterval.from_duration(start_time, end_time)
-ti2.start_time.to_s  # => '2015-12-12T19:53:00Z'
-ti2.end_time.to_s    # => '2015-12-13T19:53:00Z'
-ti2.size             # => 86_400.0
-```
-
-## Operate with time intervals
-
-`TimeInterval` is `Comparable`, so you can use the usual `<`, `>`, `<=`, `>=`,
-`==` to compare against another `TimeInterval`.  Is equivalent to get the
-amount of seconds via `#to_f` and compare the resulting numbers.
-
-A time interval can be viewed as an ordered set of datetime elements:
-
-* `#empty?` checks if an interval is empty.
-* `#include?` checks if a `DateTime` is part of the time interval.
-* `#intersect?` checks if two time intervals overlap.
-* `#intersection` returns the intersected time interval if the two intervals intersect.
-* `#disjoint?` checks if two time intervals don't intersect.
-* `#subset?` checks if a time interval is included in another one.
-* `#superset?` checks if a time interval is included in another one.
-* `#first` is the lower bound.
-* `#last` is the upper bound.
-* `#size` is the total amount of seconds.
-
-
-You can convert a time interval into a string with `#to_s` or into a float via
-`#to_f`.