version_gem 1.1.6 → 1.1.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 779a53b7ab4b5e47e80eedc36f0551e2786886dcac2eb91928537bc9535793cd
-  data.tar.gz: 8c51c4dc1e88dd9e144dc22197f3992096e2da71ab55e324ca59aec907a40eb1
+  metadata.gz: 90cc40b0bf2d460aecbcd09d57edcff0a7d5d57b364ecad37a006ffea01390bc
+  data.tar.gz: 48057a10145944f754e9ad2fbc3cf6892d36f742b684483cbebd4421d966b275
 SHA512:
-  metadata.gz: 4944471f27fa5bf9013c4f1009ae0ae21f81fe92b345ff3f5a4b400861147dbbb67d10323222278dacb1b92a1f4eddf2e2fc6aef069e3e7b89d637507ee70518
-  data.tar.gz: 7a030e85c153ec35b2075a18e24a3ba3f64b8fb6c7891f794beea9e45c7b4a130e32e6a350a397a4df3888981704696c2f1fb6d076a362da5fa0a578ed7326f9
+  metadata.gz: 3e2c38503358416ef03fd15c174d392228385d75c000b137394098367e27167a96221de652815c4b509376bfc432ce32ed384370b997b37c2e3a90fb3cdc32f8
+  data.tar.gz: ae251c1c3bd424472f94efa84c3b0d111d0d20054d442b116bb3ae7ad3a7b4afef690d408b157a32f64256dc1daefb8ade74ed7922e501d65cdc23e5003822c4

data/CHANGELOG.md

@@ -22,6 +22,19 @@ Please file a bug if you notice a violation of semantic versioning.
 ### Fixed
 ### Removed
 
+## [1.1.7] 2025-04-15 ([tag][1.1.7t])
+- Line Coverage: 100.0% (117 / 117)
+- Branch Coverage: 100.0% (4 / 4)
+-  76.92% documented
+### Added
+- Support for Epoch Semantic Versioning
+  - `extend VersionGem::Epoch` in your library's `MyLib::Version` module
+- Support for JRuby 10 (@pboling)
+- More documentation (@pboling)
+### Removed
+- Ruby 2.2 removed from CI, though technically still supported
+  - can't run directly in GHA anymore
+
 ## [1.1.6] 2025-02-24 ([tag][1.1.6t])
 - Line Coverage: 100.0% (77 / 77)
 - Branch Coverage: 100.0% (2 / 2)
@@ -117,7 +130,9 @@ Please file a bug if you notice a violation of semantic versioning.
 ### Added
 - Initial release, with basic version parsing API (@pboling)
 
-[Unreleased]: https://gitlab.com/oauth-xx/version_gem/-/compare/v1.1.6...main
+[Unreleased]: https://gitlab.com/oauth-xx/version_gem/-/compare/v1.1.7...main
+[1.1.7]: https://gitlab.com/oauth-xx/version_gem/-/compare/v1.1.6...v1.1.7
+[1.1.7t]: https://gitlab.com/oauth-xx/oauth2/-/tags/v1.1.7
 [1.1.6]: https://gitlab.com/oauth-xx/version_gem/-/compare/v1.1.5...v1.1.6
 [1.1.6t]: https://gitlab.com/oauth-xx/oauth2/-/tags/v1.1.6
 [1.1.5]: https://gitlab.com/oauth-xx/version_gem/-/compare/v1.1.4...v1.1.5

data/README.md

@@ -17,7 +17,6 @@
 [![CI Legacy][🚎4-lg-wfi]][🚎4-lg-wf]
 [![CI Unsupported][🚎7-us-wfi]][🚎7-us-wf]
 [![CI Ancient][🚎1-an-wfi]][🚎1-an-wf]
-[![CI Hoary][🚎8-ho-wfi]][🚎8-ho-wf]
 [![CI Test Coverage][🚎2-cov-wfi]][🚎2-cov-wf]
 [![CI Style][🚎5-st-wfi]][🚎5-st-wf]
 
@@ -26,7 +25,7 @@
 [![Liberapay Patrons][⛳liberapay-img]][⛳liberapay]
 [![Sponsor Me on Github][🖇sponsor-img]][🖇sponsor]
 [![Buy me a coffee][🖇buyme-small-img]][🖇buyme]
-[![Polar Shield][🖇polar-img]][🖇polar]
+[![Donate on Polar][🖇polar-img]][🖇polar]
 [![Donate to my FLOSS or refugee efforts at ko-fi.com][🖇kofi-img]][🖇kofi]
 [![Donate to my FLOSS or refugee efforts using Patreon][🖇patreon-img]][🖇patreon]
 
@@ -39,7 +38,7 @@ This gem has a very niche purpose, which is:
 3. allowing 100% test coverage of Ruby code, including the `Version` module.
 
 As proof in the pudding, this gem achieves 100% test coverage for lines and branches,
-all 77 and 2 of them, respectively; coverage enabled in part by patterns from this library.
+all 117 and 4 of them, respectively; coverage enabled in part by patterns from this library.
 You can make it happen for your library too!
 
 If this isn't **precisely** your use case you may be better off looking at
@@ -70,10 +69,10 @@ This gem has no runtime dependencies.
 
 | Tokens to Remember      | [![Gem name][⛳️name-img]][⛳️gem-name] [![Gem namespace][⛳️namespace-img]][⛳️gem-namespace]                                                                                                                                                                                                                                                                                                                                                                          |
 |-------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| Works with JRuby        | [![JRuby 9.1 Compat][💎jruby-9.1i]][🚎10-j-wf] [![JRuby 9.2 Compat][💎jruby-9.2i]][🚎10-j-wf] [![JRuby 9.3 Compat][💎jruby-9.3i]][🚎10-j-wf] [![JRuby 9.4 Compat][💎jruby-c-i]][🚎11-c-wf] [![JRuby HEAD Compat][💎jruby-headi]][🚎3-hd-wf]                                                                                                                                                                                                                         |
+| Works with JRuby        | [![JRuby 9.1 Compat][💎jruby-9.1i]][🚎10-j-wf] [![JRuby 9.2 Compat][💎jruby-9.2i]][🚎10-j-wf] [![JRuby 9.3 Compat][💎jruby-9.3i]][🚎10-j-wf] [![JRuby 9.4 Compat][💎jruby-9.4i]][🚎10-j-wf] [![JRuby 10.0 Compat][💎jruby-c-i]][🚎11-c-wf] [![JRuby HEAD Compat][💎jruby-headi]][🚎3-hd-wf]                                                                                                                                                                         |
 | Works with Truffle Ruby | [![Truffle Ruby 22.3 Compat][💎truby-22.3i]][🚎9-t-wf] [![Truffle Ruby 23.0 Compat][💎truby-23.0i]][🚎9-t-wf] [![Truffle Ruby 23.1 Compat][💎truby-23.1i]][🚎9-t-wf] [![Truffle Ruby 24.1 Compat][💎truby-c-i]][🚎11-c-wf] [![Truffle Ruby HEAD Compat][💎truby-headi]][🚎3-hd-wf]                                                                                                                                                                                  |
 | Works with MRI Ruby 3   | [![Ruby 3.0 Compat][💎ruby-3.0i]][🚎4-lg-wf] [![Ruby 3.1 Compat][💎ruby-3.1i]][🚎6-s-wf] [![Ruby 3.2 Compat][💎ruby-3.2i]][🚎6-s-wf] [![Ruby 3.3 Compat][💎ruby-3.3i]][🚎6-s-wf] [![Ruby 3.4 Compat][💎ruby-c-i]][🚎11-c-wf] [![Ruby HEAD Compat][💎ruby-headi]][🚎3-hd-wf]                                                                                                                                                                                         |
-| Works with MRI Ruby 2   | [![Ruby 2.2 Compat][💎ruby-2.2i]][🚎8-ho-wf] [![Ruby 2.3 Compat][💎ruby-2.3i]][🚎1-an-wf] [![Ruby 2.4 Compat][💎ruby-2.4i]][🚎1-an-wf] [![Ruby 2.5 Compat][💎ruby-2.5i]][🚎1-an-wf] [![Ruby 2.6 Compat][💎ruby-2.6i]][🚎7-us-wf] [![Ruby 2.7 Compat][💎ruby-2.7i]][🚎7-us-wf]                                                                                                                                                                                       |
+| Works with MRI Ruby 2   | [![Ruby 2.3 Compat][💎ruby-2.3i]][🚎1-an-wf] [![Ruby 2.4 Compat][💎ruby-2.4i]][🚎1-an-wf] [![Ruby 2.5 Compat][💎ruby-2.5i]][🚎1-an-wf] [![Ruby 2.6 Compat][💎ruby-2.6i]][🚎7-us-wf] [![Ruby 2.7 Compat][💎ruby-2.7i]][🚎7-us-wf]                                                                                                                                                                                                                                    |
 | Source                  | [![Source on GitLab.com][📜src-gl-img]][📜src-gl] [![Source on Github.com][📜src-gh-img]][📜src-gh] [![The best SHA: dQw4w9WgXcQ!][🧮kloc-img]][🧮kloc]                                                                                                                                                                                                                                                                                                             |
 | Documentation           | [![Current release on RubyDoc.info][📜docs-cr-rd-img]][🚎yard-current] [![HEAD on RubyDoc.info][📜docs-head-rd-img]][🚎yard-head] [![BDFL Blog][🚂bdfl-blog-img]][🚂bdfl-blog] [![Wiki][📜wiki-img]][📜wiki]                                                                                                                                                                                                                                                        |
 | Compliance              | [![License: MIT][📄license-img]][📄license-ref] [![📄ilo-declaration-img]][📄ilo-declaration] [![Security Policy][🔐security-img]][🔐security] [![CodeQL][🖐codeQL-img]][🖐codeQL] [![Contributor Covenant 2.1][🪇conduct-img]][🪇conduct] [![SemVer 2.0.0][📌semver-img]][📌semver] [![Keep-A-Changelog 1.0.0][📗keep-changelog-img]][📗keep-changelog]                                                                                                            |
@@ -92,7 +91,7 @@ If bundler is not being used to manage dependencies, install the gem by executin
 
     $ gem install version_gem
 
-## Usage
+## Basic Usage
 
 In the standard `bundle gem my_lib` code you get the following in `lib/my_lib/version.rb`:
 
@@ -162,7 +161,96 @@ end
 
 Your `version.rb` file now abides the Ruby convention of directory / path matching the namespace / class!
 
-### Zietwerk
+## Epoch Usage (Epoch Semantic Versioning, as of version 1.1.7)
+
+In the standard `bundle gem my_lib` code you get the following in `lib/my_lib/version.rb`:
+
+```ruby
+module MyLib
+  VERSION = "0.1.0"
+end
+```
+
+Change it to a nested `Version` namespace (the one implied by the path => namespace convention):
+
+```ruby
+module MyLib
+  module Version
+    VERSION = "0.1.0"
+  end
+end
+```
+
+The Epoch and Major versions are derived from the formula:
+
+```
+{EPOCH * 1000 + MAJOR}.MINOR.PATCH
+```
+
+This will start your library with the following version segments:
+
+* `epoch = 0`
+* `major = 0`
+* `minor = 1`
+* `patch = 0`
+* `pre = nil`
+
+And the segments are defined as:
+
+```
+EPOCH: Increment when you make significant or groundbreaking changes.
+MAJOR: Increment when you make minor incompatible API changes.
+MINOR: Increment when you add functionality in a backwards-compatible manner.
+PATCH: Increment when you make backwards-compatible bug fixes.
+```
+
+Therefore, if you set your version number to:
+
+```ruby
+VERSION = "27016.42.86-pre.7"
+```
+
+You will get the following version segments:
+
+```
+{
+  epoch: 27,
+  major: 16,
+  minor: 42,
+  patch: 86,
+  pre: "pre-7",
+}
+```
+
+Now add the following near the top of the file the manages requiring external libraries.
+Using the same example of `bundle gem my_lib`, this would be `lib/my_lib.rb`.
+
+```ruby
+require "version_gem"
+```
+
+Then, add the following wherever you want in the same file (recommend the bottom).
+
+```ruby
+MyLib::Version.class_eval do
+  extend VersionGem::Epoch
+end
+```
+
+And now you have some version introspection methods available:
+
+```ruby
+MyLib::Version.to_s # => "1024.3.8"
+MyLib::Version.epoch # => 1
+MyLib::Version.major # => 24
+MyLib::Version.minor # => 3
+MyLib::Version.patch # => 8
+MyLib::Version.pre # => ""
+MyLib::Version.to_a # => [1, 24, 3, 8]
+MyLib::Version.to_h # => { epoch: 1, major: 24, minor: 3, patch: 8, pre: "" }
+```
+
+## Usage with Zeitwerk
 
 The pattern of `version.rb` breaking the ruby convention of directory / path matching the namespace / class
 is so entrenched that the `zeitwerk` library has a special carve-out for it. 🥺
@@ -260,9 +348,11 @@ RSpec.describe(MyLib::Version) do
     expect(described_class).to(have_version_as_string)
     expect(described_class.to_s).to(be_a(String))
     expect(described_class).to(have_major_as_integer)
+    expect(described_class).to(have_epoch_as_integer)
     expect(described_class).to(have_minor_as_integer)
     expect(described_class).to(have_patch_as_integer)
     expect(described_class).to(have_pre_as_nil_or_string)
+    # This would be %i[epoch major minor patch pre] for epoch version schemes
     expect(described_class.to_h.keys).to(match_array(%i[major minor patch pre]))
     expect(described_class.to_a).to(be_a(Array))
   end
@@ -312,11 +402,13 @@ Also see GitLab Contributors: [https://gitlab.com/oauth-xx/version_gem/-/graphs/
 
 ## 📌 Versioning
 
-This Library adheres to [![Semantic Versioning 2.0.0][📌semver-img]][📌semver].
+This Library adheres to [![Epoch Semantic Versioning][📌semver-img]][📌semver].
 Violations of this scheme should be reported as bugs.
 Specifically, if a minor or patch version is released that breaks backward compatibility,
 a new version should be immediately released that restores compatibility.
-Breaking changes to the public API will only be introduced with new major versions.
+Breaking changes to the public API, including dropping a supported platform (i.e. minor version of Ruby),
+will only be introduced with new major versions.
+Epoch will only be bumped if there are dramatic changes, and that is not expected to happen ever.
 
 ### 📌 Is "Platform Support" part of the public API?
 
@@ -426,10 +518,10 @@ or one of the others at the head of this README.
 [👽oss-helpi]: https://www.codetriage.com/oauth-xx/version_gem/badges/users.svg
 [👽version]: https://rubygems.org/gems/version_gem
 [👽versioni]: https://img.shields.io/gem/v/version_gem.svg
-[🔑cc-mnt]: https://codeclimate.com/github/oauth-xx/version_gem/maintainability
-[🔑cc-mnti♻️]: https://api.codeclimate.com/v1/badges/e26c543320ca0d14e871/maintainability
-[🔑cc-cov]: https://codeclimate.com/github/oauth-xx/version_gem/test_coverage
-[🔑cc-covi♻️]: https://api.codeclimate.com/v1/badges/e26c543320ca0d14e871/test_coverage
+[🔑cc-mnt]: https://qlty.sh/gh/oauth-xx/projects/version_gem
+[🔑cc-mnti♻️]: https://qlty.sh/badges/19404e90-9168-451a-8dac-882382cb768d/maintainability.svg
+[🔑cc-cov]: https://qlty.sh/gh/oauth-xx/projects/version_gem
+[🔑cc-covi♻️]: https://qlty.sh/badges/19404e90-9168-451a-8dac-882382cb768d/test_coverage.svg
 [🔑codecov]: https://codecov.io/gh/oauth-xx/version_gem
 [🔑codecovi♻️]: https://codecov.io/gh/oauth-xx/version_gem/branch/main/graph/badge.svg?token=cc6UdZCpAL
 [🔑coveralls]: https://coveralls.io/github/oauth-xx/version_gem?branch=main
@@ -452,8 +544,6 @@ or one of the others at the head of this README.
 [🚎6-s-wfi]: https://github.com/oauth-xx/version_gem/actions/workflows/supported.yml/badge.svg
 [🚎7-us-wf]: https://github.com/oauth-xx/version_gem/actions/workflows/unsupported.yml
 [🚎7-us-wfi]: https://github.com/oauth-xx/version_gem/actions/workflows/unsupported.yml/badge.svg
-[🚎8-ho-wf]: https://github.com/oauth-xx/version_gem/actions/workflows/hoary.yml
-[🚎8-ho-wfi]: https://github.com/oauth-xx/version_gem/actions/workflows/hoary.yml/badge.svg
 [🚎9-t-wf]: https://github.com/oauth-xx/version_gem/actions/workflows/truffle.yml
 [🚎9-t-wfi]: https://github.com/oauth-xx/version_gem/actions/workflows/truffle.yml/badge.svg
 [🚎10-j-wf]: https://github.com/oauth-xx/version_gem/actions/workflows/jruby.yml
@@ -464,13 +554,15 @@ or one of the others at the head of this README.
 [⛳liberapay]: https://liberapay.com/pboling/donate
 [🖇sponsor-img]: https://img.shields.io/badge/Sponsor_Me!-pboling.svg?style=social&logo=github
 [🖇sponsor]: https://github.com/sponsors/pboling
-[🖇polar-img]: https://polar.sh/embed/seeks-funding-shield.svg?org=pboling
+[🖇polar-img]: https://img.shields.io/badge/polar-donate-yellow.svg
 [🖇polar]: https://polar.sh/pboling
-[🖇kofi-img]: https://img.shields.io/badge/buy_me_coffee-donate-yellow.svg
+[🖇kofi-img]: https://img.shields.io/badge/a_more_different_coffee-✓-yellow.svg
 [🖇kofi]: https://ko-fi.com/O5O86SNP4
 [🖇patreon-img]: https://img.shields.io/badge/patreon-donate-yellow.svg
 [🖇patreon]: https://patreon.com/galtzo
-[💎ruby-2.2i]: https://img.shields.io/badge/Ruby-2.2-DF00CA?style=for-the-badge&logo=ruby&logoColor=white
+[🖇buyme-img]: https://img.buymeacoffee.com/button-api/?text=Buy%20me%20a%20latte&emoji=&slug=pboling&button_colour=FFDD00&font_colour=000000&font_family=Cookie&outline_colour=000000&coffee_colour=ffffff
+[🖇buyme]: https://www.buymeacoffee.com/pboling
+[🖇buyme-small-img]: https://img.shields.io/badge/buy_me_a_coffee-✓-yellow.svg?style=flat
 [💎ruby-2.3i]: https://img.shields.io/badge/Ruby-2.3-DF00CA?style=for-the-badge&logo=ruby&logoColor=white
 [💎ruby-2.4i]: https://img.shields.io/badge/Ruby-2.4-DF00CA?style=for-the-badge&logo=ruby&logoColor=white
 [💎ruby-2.5i]: https://img.shields.io/badge/Ruby-2.5-DF00CA?style=for-the-badge&logo=ruby&logoColor=white
@@ -490,6 +582,7 @@ or one of the others at the head of this README.
 [💎jruby-9.1i]: https://img.shields.io/badge/JRuby-9.1-FBE742?style=for-the-badge&logo=ruby&logoColor=red
 [💎jruby-9.2i]: https://img.shields.io/badge/JRuby-9.2-FBE742?style=for-the-badge&logo=ruby&logoColor=red
 [💎jruby-9.3i]: https://img.shields.io/badge/JRuby-9.3-FBE742?style=for-the-badge&logo=ruby&logoColor=red
+[💎jruby-9.4i]: https://img.shields.io/badge/JRuby-9.4-FBE742?style=for-the-badge&logo=ruby&logoColor=red
 [💎jruby-c-i]: https://img.shields.io/badge/JRuby-current-FBE742?style=for-the-badge&logo=ruby&logoColor=green
 [💎jruby-headi]: https://img.shields.io/badge/JRuby-HEAD-FBE742?style=for-the-badge&logo=ruby&logoColor=blue
 [🤝issues]: https://github.com/oauth-xx/version_gem/issues
@@ -503,15 +596,15 @@ or one of the others at the head of this README.
 [🪇conduct]: CODE_OF_CONDUCT.md
 [🪇conduct-img]: https://img.shields.io/badge/Contributor_Covenant-2.1-4baaaa.svg
 [📌pvc]: http://guides.rubygems.org/patterns/#pessimistic-version-constraint
-[📌semver]: https://semver.org/spec/v2.0.0.html
-[📌semver-img]: https://img.shields.io/badge/semver-2.0.0-FFDD67.svg?style=flat
+[📌semver]: https://antfu.me/posts/epoch-semver
+[📌semver-img]: https://img.shields.io/badge/epoch-semver-FFDD67.svg?style=flat
 [📌semver-breaking]: https://github.com/semver/semver/issues/716#issuecomment-869336139
 [📌major-versions-not-sacred]: https://tom.preston-werner.com/2022/05/23/major-version-numbers-are-not-sacred.html
 [📌changelog]: CHANGELOG.md
 [📗keep-changelog]: https://keepachangelog.com/en/1.0.0/
 [📗keep-changelog-img]: https://img.shields.io/badge/keep--a--changelog-1.0.0-FFDD67.svg?style=flat
 [🧮kloc]: https://www.youtube.com/watch?v=dQw4w9WgXcQ
-[🧮kloc-img]: https://img.shields.io/badge/KLOC-0.077-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-0.117-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
 [🔐security]: SECURITY.md
 [🔐security-img]: https://img.shields.io/badge/security-policy-brightgreen.svg?style=flat
 [📄copyright-notice-explainer]: https://opensource.stackexchange.com/questions/5778/why-do-licenses-such-as-the-mit-license-specify-a-single-year
@@ -522,6 +615,3 @@ or one of the others at the head of this README.
 [📄ilo-declaration-img]: https://img.shields.io/badge/ILO_Fundamental_Principles-✓-brightgreen.svg?style=flat
 [🚎yard-current]: http://rubydoc.info/gems/version_gem
 [🚎yard-head]: https://rubydoc.info/github/oauth-xx/version_gem/main
-[🖇buyme-img]: https://img.buymeacoffee.com/button-api/?text=Buy%20me%20a%20latte&emoji=&slug=pboling&button_colour=FFDD00&font_colour=000000&font_family=Cookie&outline_colour=000000&coffee_colour=ffffff
-[🖇buyme]: https://www.buymeacoffee.com/pboling
-[🖇buyme-small-img]: https://img.shields.io/badge/Buy--Me--A--Coffee-✓-brightgreen.svg?style=flat

data/lib/version_gem/epoch.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+require_relative "error"
+require_relative "api"
+
+module VersionGem
+  # Support for Epoch Semantic Versioning
+  # See: https://antfu.me/posts/epoch-semver
+  module Epoch
+    EPOCH_SIZE = 1_000
+
+    class << self
+      def extended(base)
+        raise Error, "VERSION must be defined before 'extend #{name}'" unless defined?(base::VERSION)
+
+        base.extend(Api)
+        base.extend(OverloadApiForEpoch)
+      end
+    end
+
+    module OverloadApiForEpoch
+      # *** OVERLOAD METHODS FROM API ***
+      #
+      # The epoch version
+      #
+      # @return [Integer]
+      def epoch
+        @epoch ||= _major / EPOCH_SIZE
+      end
+
+      # The major version
+      #
+      # @return [Integer]
+      def major
+        @major ||= _major % EPOCH_SIZE
+      end
+
+      # The version number as a hash
+      #
+      # @return [Hash]
+      def to_h
+        @to_h ||= {
+          epoch: epoch,
+          major: major,
+          minor: minor,
+          patch: patch,
+          pre: pre,
+        }
+      end
+
+      # NOTE: This is not the same as _to_a, which returns an array of strings
+      #
+      # The version number as an array of cast values
+      # where epoch and major are derived from a single string:
+      #   EPOCH * 1000 + MAJOR
+      #
+      # @return [Array<[Integer, String, NilClass]>]
+      def to_a
+        @to_a ||= [epoch, major, minor, patch, pre]
+      end
+
+      private
+
+      def _major
+        @_major ||= _to_a[0].to_i
+      end
+    end
+  end
+end

data/lib/version_gem/rspec.rb

@@ -12,6 +12,12 @@ RSpec::Matchers.define(:have_version_as_string) do
   end
 end
 
+RSpec::Matchers.define(:have_epoch_as_integer) do
+  match do |version_mod|
+    version_mod.epoch.is_a?(Integer)
+  end
+end
+
 RSpec::Matchers.define(:have_major_as_integer) do
   match do |version_mod|
     version_mod.major.is_a?(Integer)
@@ -52,3 +58,21 @@ RSpec.shared_examples_for("a Version module") do |version_mod|
     end
   end
 end
+
+RSpec.shared_examples_for("an Epoch Version module") do |version_mod|
+  it "is introspectable" do
+    aggregate_failures "introspectable api" do
+      expect(version_mod).is_a?(Module)
+      expect(version_mod).to(have_version_constant)
+      expect(version_mod).to(have_version_as_string)
+      expect(version_mod.to_s).to(be_a(String))
+      expect(version_mod).to(have_epoch_as_integer)
+      expect(version_mod).to(have_major_as_integer)
+      expect(version_mod).to(have_minor_as_integer)
+      expect(version_mod).to(have_patch_as_integer)
+      expect(version_mod).to(have_pre_as_nil_or_string)
+      expect(version_mod.to_h.keys).to(match_array(%i[epoch major minor patch pre]))
+      expect(version_mod.to_a).to(be_a(Array))
+    end
+  end
+end

data/lib/version_gem/version.rb

@@ -2,11 +2,13 @@
 
 module VersionGem
   module Version
-    VERSION = "1.1.6"
+    VERSION = "1.1.7"
     # This would work in this gem, but not in external libraries,
     #   because version files are loaded in Gemspecs before bundler
     #   has a chance to load dependencies.
     # Instead, see lib/version_gem.rb for a solution that will work everywhere
     # extend VersionGem::Basic
+    #   or
+    # extend VersionGem::Epoch
   end
 end

data/lib/version_gem.rb

@@ -2,6 +2,7 @@
 
 require_relative "version_gem/version"
 require_relative "version_gem/basic"
+require_relative "version_gem/epoch"
 
 # Namespace of this library
 module VersionGem

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: version_gem
 version: !ruby/object:Gem::Version
-  version: 1.1.6
+  version: 1.1.7
 platform: ruby
 authors:
 - Peter Boling
@@ -35,7 +35,7 @@ cert_chain:
   I5o+DRfXQHqKucx1ldFHvI2rE/kSCWqGTHN2eyu1sqCPeOoIMxrltJhaejKPkxqj
   zaF9Og==
   -----END CERTIFICATE-----
-date: 2025-02-24 00:00:00.000000000 Z
+date: 2025-04-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
@@ -116,6 +116,7 @@ files:
 - lib/version_gem.rb
 - lib/version_gem/api.rb
 - lib/version_gem/basic.rb
+- lib/version_gem/epoch.rb
 - lib/version_gem/error.rb
 - lib/version_gem/rspec.rb
 - lib/version_gem/ruby.rb
@@ -124,11 +125,11 @@ homepage: https://gitlab.com/oauth-xx/version_gem
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://gitlab.com/oauth-xx/version_gem
-  source_code_uri: https://gitlab.com/oauth-xx/version_gem/-/tree/v1.1.6
-  changelog_uri: https://gitlab.com/oauth-xx/version_gem/-/blob/v1.1.6/CHANGELOG.md
+  homepage_uri: https://railsbling.com/tags/version_gem/
+  source_code_uri: https://gitlab.com/oauth-xx/version_gem/-/tree/v1.1.7
+  changelog_uri: https://gitlab.com/oauth-xx/version_gem/-/blob/v1.1.7/CHANGELOG.md
   bug_tracker_uri: https://gitlab.com/oauth-xx/version_gem/-/issues
-  documentation_uri: https://www.rubydoc.info/gems/version_gem/1.1.6
+  documentation_uri: https://www.rubydoc.info/gems/version_gem/1.1.7
   wiki_uri: https://gitlab.com/oauth-xx/version_gem/-/wiki
   mailing_list_uri: https://groups.google.com/g/oauth-ruby
   funding_uri: https://liberapay.com/pboling
@@ -154,7 +155,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.4
+rubygems_version: 3.6.6
 specification_version: 4
 summary: Enhance your VERSION! Sugar for Version modules.
 test_files: []