rails-rfc6570 3.1.0 → 3.2.0

data/vendor/bundle/ruby/3.3.0/gems/tzinfo-2.0.6/README.md

@@ -0,0 +1,406 @@
+# TZInfo - Ruby Time Zone Library
+
+[![RubyGems](https://img.shields.io/gem/v/tzinfo?logo=rubygems&label=Gem)](https://rubygems.org/gems/tzinfo) [![Tests](https://github.com/tzinfo/tzinfo/workflows/Tests/badge.svg?branch=master&event=push)](https://github.com/tzinfo/tzinfo/actions?query=workflow%3ATests+branch%3Amaster+event%3Apush)
+
+[TZInfo](https://tzinfo.github.io) is a Ruby library that provides access to
+time zone data and allows times to be converted using time zone rules.
+
+
+## Data Sources
+
+TZInfo requires a source of time zone data. There are two options:
+
+1. A zoneinfo directory containing timezone definition files. These files are
+   generated from the [IANA Time Zone Database](https://www.iana.org/time-zones)
+   using the `zic` utility. Most Unix-like systems include a zoneinfo directory.
+2. The TZInfo::Data library (the tzinfo-data gem). TZInfo::Data contains a set
+   of Ruby modules that are also generated from the IANA Time Zone Database.
+
+By default, TZInfo will attempt to use TZInfo::Data. If TZInfo::Data is not
+available (i.e. if `require 'tzinfo/data'` fails), then TZInfo will search for a
+zoneinfo directory instead (using the search path specified by
+`TZInfo::ZoneinfoDataSource::DEFAULT_SEARCH_PATH`).
+
+If no data source can be found, a `TZInfo::DataSourceNotFound` exception will be
+raised when TZInfo is used. Further information is available
+[in the wiki](https://tzinfo.github.io/datasourcenotfound) to help resolve
+`TZInfo::DataSourceNotFound` errors.
+
+The default data source selection can be overridden by calling
+`TZInfo::DataSource.set`.
+
+Custom data sources can also be used. See the `TZInfo::DataSource.set`
+documentation for further details.
+
+
+## Installation
+
+The TZInfo gem can be installed by running `gem install tzinfo` or by adding
+`gem 'tzinfo'` to your `Gemfile` and running `bundle install`.
+
+To use the Ruby modules as the data source, TZInfo::Data will also need to be
+installed by running `gem install tzinfo-data` or by adding `gem 'tzinfo-data'`
+to your `Gemfile`.
+
+
+## IANA Time Zone Database
+
+The data returned and used by TZInfo is sourced from the
+[IANA Time Zone Database](http://www.iana.org/time-zones). The
+[Theory and pragmatics of the tz code and data](https://data.iana.org/time-zones/theory.html)
+document gives details of how the data is organized and managed.
+
+
+## Example Usage
+
+To use TZInfo, it must first be required with:
+
+```ruby
+require 'tzinfo'
+```
+
+The `TZInfo::Timezone` class provides access to time zone data and methods for
+converting times.
+
+The `all_identifiers` method returns a list of valid time zone identifiers:
+
+```ruby
+identifiers = TZInfo::Timezone.all_identifiers
+# => ["Africa/Adibdjan", "Africa/Accra", ..., "Zulu"]
+```
+
+A `TZInfo::Timezone` instance representing an individual time zone can be
+obtained with `TZInfo::Timezone.get`:
+
+```ruby
+tz = TZInfo::Timezone.get('America/New_York')
+# => #<TZInfo::DataTimezone: America/New_York>
+```
+
+A time can be converted to the local time of the time zone with `to_local`:
+
+```ruby
+tz.to_local(Time.utc(2018, 2, 1, 12, 30, 0))
+# => 2018-02-01 07:30:00 -0500
+tz.to_local(Time.utc(2018, 7, 1, 12, 30, 0))
+# => 2018-07-01 08:30:00 -0400
+tz.to_local(Time.new(2018, 7, 1, 13, 30, 0, '+01:00'))
+# => 2018-07-01 08:30:00 -0400
+```
+
+Local times with the appropriate offset for the time zone can be constructed
+with `local_time`:
+
+```ruby
+tz.local_time(2018, 2, 1, 7, 30, 0)
+# => 2018-02-01 07:30:00 -0500
+tz.local_time(2018, 7, 1, 8, 30, 0)
+# => 2018-07-01 08:30:00 -0400
+```
+
+Local times can be converted to UTC by using `local_time` and calling `utc` on
+the result:
+
+```ruby
+tz.local_time(2018, 2, 1, 7, 30, 0).utc
+# => 2018-02-01 12:30:00 UTC
+tz.local_time(2018, 7, 1, 8, 30, 0).utc
+# => 2018-07-01 12:30:00 UTC
+```
+
+The `local_to_utc` method can also be used to convert a time object to UTC. The
+offset of the time is ignored - it is treated as if it were a local time for the
+time zone:
+
+```ruby
+tz.local_to_utc(Time.utc(2018, 2, 1, 7, 30, 0))
+# => 2018-02-01 12:30:00 UTC
+tz.local_to_utc(Time.new(2018, 2, 1, 7, 30, 0, '+01:00'))
+# => 2018-02-01 12:30:00 UTC
+```
+
+Information about the time zone can be obtained from returned local times:
+
+```ruby
+local_time = tz.to_local(Time.utc(2018, 2, 1, 12, 30, 0))
+local_time.utc_offset  # => -18000
+local_time.dst?        # => false
+local_time.zone        # => "EST"
+
+local_time = tz.to_local(Time.utc(2018, 7, 1, 12, 30, 0))
+local_time.utc_offset  # => -14400
+local_time.dst?        # => true
+local_time.zone        # => "EDT"
+```
+
+Time zone information can be included when formatting times with `strftime`
+using the `%z` and `%Z` directives:
+
+```ruby
+tz.to_local(Time.utc(2018, 2, 1, 12, 30, 0)).strftime('%Y-%m-%d %H:%M:%S %z %Z')
+# => "2018-02-01 07:30:00 -0500 EST"
+tz.to_local(Time.utc(2018, 7, 1, 12, 30, 0)).strftime('%Y-%m-%d %H:%M:%S %z %Z')
+# => "2018-07-01 08:30:00 -0400 EDT"
+```
+
+The `period_for` method can be used to obtain information about the observed
+time zone information at a particular time as a `TZInfo::TimezonePeriod` object:
+
+```ruby
+period = tz.period_for(Time.utc(2018, 7, 1, 12, 30, 0))
+period.base_utc_offset          # => -18000
+period.std_offset               # => 3600
+period.observed_utc_offset      # => -14400
+period.abbreviation             # => "EDT"
+period.dst?                     # => true
+period.local_starts_at.to_time  # => 2018-03-11 03:00:00 -0400
+period.local_ends_at.to_time    # => 2018-11-04 02:00:00 -0400
+```
+
+A list of transitions between periods where different rules are observed can be
+obtained with the `transitions_up_to` method. The result is returned as an
+`Array` of `TZInfo::TimezoneTransition` objects:
+
+```ruby
+transitions = tz.transitions_up_to(Time.utc(2019, 1, 1), Time.utc(2017, 1, 1))
+transitions.map do |t|
+  [t.local_end_at.to_time, t.offset.observed_utc_offset, t.offset.abbreviation]
+end
+# => [[2017-03-12 02:00:00 -0500, -14400, "EDT"],
+#     [2017-11-05 02:00:00 -0400, -18000, "EST"],
+#     [2018-03-11 02:00:00 -0500, -14400, "EDT"],
+#     [2018-11-04 02:00:00 -0400, -18000, "EST"]]
+```
+
+A list of the unique offsets used by a time zone can be obtained with the
+`offsets_up_to` method. The result is returned as an `Array` of
+`TZInfo::TimezoneOffset` objects:
+
+```ruby
+offsets = tz.offsets_up_to(Time.utc(2019, 1, 1))
+offsets.map {|o| [o.observed_utc_offset, o.abbreviation] }
+# => [[-17762, "LMT"],
+#     [-18000, "EST"],
+#     [-14400, "EDT"],
+#     [-14400, "EWT"],
+#     [-14400, "EPT"]]
+```
+
+All `TZInfo::Timezone` methods that accept a time as a parameter can be used
+with either instances of `Time`, `DateTime` or `TZInfo::Timestamp`. Arbitrary
+`Time`-like objects that respond to both `to_i` and `subsec` and optionally
+`utc_offset` will be treated as if they are instances of `Time`.
+
+`TZInfo::Timezone` methods that both accept and return times will return an
+object with a type matching that of the parameter (actually a
+`TZInfo::TimeWithOffset`, `TZInfo::DateTimeWithOffset` or
+`TZInfo::TimestampWithOffset` subclass when returning a local time):
+
+```ruby
+tz.to_local(Time.utc(2018, 7, 1, 12, 30, 0))
+# => 2018-07-01 08:30:00 -0400
+tz.to_local(DateTime.new(2018, 7, 1, 12, 30, 0))
+# => #<TZInfo::DateTimeWithOffset: 2018-07-01T08:30:00-04:00 ((2458301j,45000s,0n),-14400s,2299161j)>
+tz.to_local(TZInfo::Timestamp.create(2018, 7, 1, 12, 30, 0, 0, :utc))
+# => #<TZInfo::TimestampWithOffset: @value=1530448200, @sub_second=0, @utc_offset=-14400, @utc=false>
+```
+
+In addition to `local_time`, which returns `Time` instances, the
+`local_datetime` and `local_timestamp` methods can be used to construct local
+`DateTime` and `TZInfo::Timestamp` instances with the appropriate offset:
+
+```ruby
+tz.local_time(2018, 2, 1, 7, 30, 0)
+# => 2018-02-01 07:30:00 -0500
+tz.local_datetime(2018, 2, 1, 7, 30, 0)
+# => #<TZInfo::DateTimeWithOffset: 2018-02-01T07:30:00-05:00 ((2458151j,45000s,0n),-18000s,2299161j)>
+tz.local_timestamp(2018, 2, 1, 7, 30, 0)
+# => #<TZInfo::TimestampWithOffset: @value=1517488200, @sub_second=0, @utc_offset=-18000, @utc=false>
+```
+
+The `local_to_utc`, `local_time`, `local_datetime` and `local_timestamp` methods
+may raise a `TZInfo::PeriodNotFound` or a `TZInfo::AmbiguousTime` exception.
+`TZInfo::PeriodNotFound` signals that there is no equivalent UTC time (for
+example, during the transition from standard time to daylight savings time when
+the clocks are moved forward and an hour is skipped). `TZInfo::AmbiguousTime`
+signals that there is more than one equivalent UTC time (for example, during the
+transition from daylight savings time to standard time where the clocks are
+moved back and an hour is repeated):
+
+```ruby
+tz.local_time(2018, 3, 11, 2, 30, 0, 0)
+# raises TZInfo::PeriodNotFound (2018-03-11 02:30:00 is an invalid local time.)
+tz.local_time(2018, 11, 4, 1, 30, 0, 0)
+# raises TZInfo::AmbiguousTime (2018-11-04 01:30:00 is an ambiguous local time.)
+```
+
+`TZInfo::PeriodNotFound` exceptions can only be resolved by adjusting the time,
+for example, by advancing an hour:
+
+```ruby
+tz.local_time(2018, 3, 11, 3, 30, 0, 0)
+# => 2018-03-11 03:30:00 -0400
+```
+
+`TZInfo::AmbiguousTime` exceptions can be resolved by setting the `dst`
+parameter and/or specifying a block to choose one of the interpretations:
+
+```ruby
+tz.local_time(2018, 11, 4, 1, 30, 0, 0, true)
+# => 2018-11-04 01:30:00 -0400
+tz.local_time(2018, 11, 4, 1, 30, 0, 0, false)
+# => 2018-11-04 01:30:00 -0500
+
+tz.local_time(2018, 11, 4, 1, 30, 0, 0) {|p| p.first }
+# => 2018-11-04 01:30:00 -0400
+tz.local_time(2018, 11, 4, 1, 30, 0, 0) {|p| p.last }
+# => 2018-11-04 01:30:00 -0500
+```
+
+The default value of the `dst` parameter can also be set globally:
+
+```ruby
+TZInfo::Timezone.default_dst = true
+tz.local_time(2018, 11, 4, 1, 30, 0, 0)
+# => 2018-11-04 01:30:00 -0400
+TZInfo::Timezone.default_dst = false
+tz.local_time(2018, 11, 4, 1, 30, 0, 0)
+# => 2018-11-04 01:30:00 -0500
+```
+
+TZInfo also provides information about
+[ISO 3166-1](https://www.iso.org/iso-3166-country-codes.html) countries and
+their associated time zones via the `TZInfo::Country` class.
+
+A list of valid ISO 3166-1 (alpha-2) country codes can be obtained by calling
+`TZInfo::Country.all_codes`:
+
+```ruby
+TZInfo::Country.all_codes
+# => ["AD", "AE", ..., "ZW"]
+```
+
+A `TZInfo::Country` instance representing an individual time zone can be
+obtained with `TZInfo::Country.get`:
+
+```ruby
+c = TZInfo::Country.get('US')
+# => #<TZInfo::Country: US>
+c.name
+# => "United States"
+```
+
+The `zone_identifiers` method returns a list of the time zone identifiers used
+in a country:
+
+```ruby
+c.zone_identifiers
+# => ["America/New_York", "America/Detroit", ..., "Pacific/Honolulu"]
+```
+
+The `zone_info` method returns further information about the time zones used in
+a country as an `Array` of `TZInfo::CountryTimezone` instances:
+
+```ruby
+zi = c.zone_info.first
+zi.identifier               # => "America/New_York"
+zi.latitude.to_f.round(5)   # => 40.71417
+zi.longitude.to_f.round(5)  # => -74.00639
+zi.description              # => "Eastern (most areas)"
+```
+
+The `zones` method returns an `Array` of `TZInfo::Timezone` instances for a
+country. A `TZInfo::Timezone` instance can be obtained from a
+`TZInfo::CountryTimezone` using the `timezone` method:
+
+```ruby
+zi.timezone.to_local(Time.utc(2018, 2, 1, 12, 30, 0))
+# => 2018-02-01 07:30:00 -0500
+```
+
+For further detail, please refer to the API documentation for the
+`TZInfo::Timezone` and `TZInfo::Country` classes.
+
+
+## Time Zone Selection
+
+The Time Zone Database maintainers recommend that time zone identifiers are not
+made visible to end-users (see [Names of
+timezones](https://data.iana.org/time-zones/theory.html#naming)).
+
+Instead of displaying a list of time zone identifiers, time zones can be
+selected by the user's country. Call `TZInfo::Country.all` to obtain a list of
+`TZInfo::Country` objects, each with a unique `code` and a `name` that can be
+used for display purposes.
+
+Most countries have a single time zone. When choosing such a country, the time
+zone can be inferred and selected automatically.
+
+```ruby
+croatia = TZInfo::Country.get('HR')
+# => #<TZInfo::Country: HR>
+croatia.zone_info.length
+# => 1
+croatia.zone_info[0].identifier
+# => "Europe/Belgrade"
+```
+
+Some countries have multiple time zones. The `zone_info` method can be used
+to obtain a list of user-friendly descriptions of the available options:
+
+```ruby
+australia = TZInfo::Country.get('AU')
+# => #<TZInfo::Country: AU>
+australia.zone_info.length
+# => 13
+australia.zone_info.map {|i| [i.identifier, i.description] }
+# => [["Australia/Lord_Howe", "Lord Howe Island"],
+#     ["Antarctica/Macquarie", "Macquarie Island"],
+#     ...
+#     ["Australia/Eucla", "Western Australia (Eucla)"]]
+```
+
+Please note that country information available through TZInfo is intended as an
+aid to help users select a time zone data appropriate for their practical needs.
+It is not intended to take or endorse any position on legal or territorial
+claims.
+
+
+## Compatibility
+
+TZInfo v2.0.0 requires a minimum of Ruby MRI 1.9.3 or JRuby 1.7 (in 1.9 mode or
+later).
+
+
+## Thread-Safety
+
+The `TZInfo::Country` and `TZInfo::Timezone` classes are thread-safe. It is safe
+to use class and instance methods of `TZInfo::Country` and `TZInfo::Timezone` in
+concurrently executing threads. Instances of both classes can be shared across
+thread boundaries.
+
+
+## Documentation
+
+API documentation for TZInfo is available on
+[RubyDoc.info](https://www.rubydoc.info/gems/tzinfo/).
+
+
+## License
+
+TZInfo is released under the MIT license, see LICENSE for details.
+
+
+## Source Code
+
+Source code for TZInfo is available on
+[GitHub](https://github.com/tzinfo/tzinfo).
+
+
+## Issue Tracker
+
+Please post any bugs, issues, feature requests or questions about TZInfo to the
+[GitHub issue tracker](https://github.com/tzinfo/tzinfo/issues).
+
+Issues with the underlying time zone data should be raised on the
+[Time Zone Database Discussion mailing list](https://mm.icann.org/mailman/listinfo/tz).

data/vendor/bundle/ruby/3.3.0/gems/unicode-display_width-2.5.0/CHANGELOG.md

@@ -0,0 +1,196 @@
+# CHANGELOG
+
+## 2.5.0
+
+- Unicode 15.1
+
+## 2.4.2
+
+More performance improvements:
+
+- Optimize lookup of first 4096 codepoints
+- Avoid overwrite lookup if no overwrites are set
+
+## 2.4.1
+
+- Improve general performance!
+- Further improve performance for ASCII strings
+
+*You should really upgrade - it's much faster now!*
+
+## 2.4.0
+- Improve performance for ASCII-only strings, by @fatkodima
+- Require Ruby 2.4
+
+## 2.3.0
+
+- Unicode 15.0
+
+## 2.2.0
+
+- Add *Hangul Jamo Extended-B* block to zero-width chars, thanks @ninjalj #22
+
+## 2.1.0
+
+- Unicode 14.0
+
+## 2.0.0
+
+- Release 2.0.0
+- Supports Ruby 3.0
+
+## 2.0.0.pre2
+
+- Update 2.0 branch to Unicode 13
+
+## 2.0.0.pre1
+
+Will be published as non-pre version on rubygems.org when Ruby 3.0 is released (December 2020)
+
+- Introduce new class-based API, which remembers your string-width configuration. See README for details.
+- Remove auto-loading of string extension
+  - You can: `require "unicode/display_width/string_ext"` to continue to use the string extension
+  - The manual opt-out `require "unicode/display_width/no_string_ext"` is not needed anymore and will
+    issue a warning in the future
+- Remove (already deprecated) String#display_size and String#display_width aliases
+
+Refactorings / Internal Changes:
+
+- Freeze string literals
+- The Unicode::DisplayWidth now is class, instead of a module, this enables the new config-object API
+
+## 1.8.0
+
+- Unicode 14.0 (last release of 1.x)
+
+## 1.7.0
+
+- Unicode 13
+
+## 1.6.1
+
+- Fix that ambiguous and overwrite options where ignored for emoji-measuring
+
+## 1.6.0
+
+- Unicode 12.1
+
+## 1.5.0
+
+- Unicode 12
+
+## 1.4.1
+
+- Only bundle required lib/* and data/* files in actual rubygem, patch by @tas50
+
+## 1.4.0
+
+- Unicode 11
+
+## 1.3.3
+
+- Replace Gem::Util.gunzip with direct zlib implementation
+  This removes the dependency on rubygems, fixes #17
+
+## 1.3.2
+
+- Explicitly load rubygems/util, fixes regression in 1.3.1 (autoload issue)
+
+## 1.3.1
+
+- Use `Gem::Util` for `gunzip`, removes deprecation warning, patch by @Schwad
+
+## 1.3.0
+
+- Unicode 10
+
+## 1.2.1
+
+- Fix bug that `emoji: true` would fail for emoji without modifier
+
+## 1.2.0
+
+- Add zero-width codepoint ranges: U+2060..U+206F, U+FFF0..U+FFF8, U+E0000..U+E0FFF
+- Add full-witdh codepoint ranges: U+3400..U+4DBF, U+4E00..U+9FFF, U+F900..U+FAFF, U+20000..U+2FFFD, U+30000..U+3FFFD
+- Experimental emoji support using the [unicode-emoji](https://github.com/janlelis/unicode-emoji) gem
+- Fix minor bug in index compression scheme
+
+## 1.1.3
+
+- Fix that non-UTF-8 encodings do not throw errors, patch by @windwiny
+
+## 1.1.2
+
+- Reduce memory consumption and increase performance, patch by @rrosenblum
+
+## 1.1.1
+
+- Always load index into memory, fixes #9
+
+## 1.1.0
+
+- Support Unicode 9.0
+
+## 1.0.5
+
+- Actually include new index from 1.0.4
+
+## 1.0.4
+
+- New index format (much smaller) and internal API changes
+- Move index generation to a builder plugin for the unicoder gem
+- No public API changes
+
+## 1.0.3
+
+- Avoid circular dependency warning
+
+## 1.0.2
+
+- Fix error that gemspec might be invalid under some circumstances (see gh#6)
+
+## 1.0.1
+
+- Inofficially allow Ruby 1.9
+
+## 1.0.0
+
+- Faster than 0.3.1
+- Advanced determination of character width
+- This includes: Treat width of most chars of general categories (Mn, Me, Cf) as 0
+- This includes: Introduce list of characters with special widths
+- Allow custom overrides for specific codepoints
+- Set required Ruby version to 2.0
+- Add NO_STRING_EXT mode to disable monkey patching
+- Internal API & index format changed drastically
+- Remove require 'unicode/display_size' (use 'unicode/display_width' instead)
+
+## 0.3.1
+
+- Faster than 0.3.0
+- Deprecate usage of aliases: String#display_size and String#display_length
+- Eliminate Ruby warnings (@amatsuda)
+
+## 0.3.0
+
+- Update EastAsianWidth from 7.0 to 8.0
+- Add rake task to update EastAsianWidth.txt
+- Move code to generate index from library to Rakefile
+- Update project's meta files
+- Deprecate requiring 'unicode-display_size'
+
+## 0.2.0
+
+- Update EastAsianWidth from 6.0 to 7.0
+- Don't build index table automatically when not available
+- Don't include EastAsianWidth.txt in gem (only index)
+
+
+## 0.1.0
+
+- Fix github issue #1
+
+
+## 0.1.0
+
+- Initial release

data/vendor/bundle/ruby/3.3.0/gems/unicode-display_width-2.5.0/MIT-LICENSE.txt

@@ -0,0 +1,22 @@
+The MIT LICENSE
+
+Copyright (c) 2011, 2015-2023 Jan Lelis
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.