versionaire 12.1.1 → 13.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8ccdc85c252a158771e6fff4663216c1ec12b8911f3f9f43a946979878ef697b
-  data.tar.gz: 73a4212cc9694cee9369b1c85d8b643b2ff9d46b8948bdf17ae667e27551c7cc
+  metadata.gz: ddea448c492c62a0bc45e8cda40984cf5695ae839e3f71cd66711b37f6de9cfd
+  data.tar.gz: 78f8baf838b4f6361d44dad88d81fab42f0f73c4e86abe4a1a5ee86fc801d5e8
 SHA512:
-  metadata.gz: 89eef3d69e55a54fe7fa11293b588e5044d970d6c28b26cb9d26905488f085aa9e23c3e82c8eda4f95598100373311c6e10191ecf3b832d82dfc35618629781f
-  data.tar.gz: 12b167c40e71526a1461882579a13dc749e9e88707d53c6ec36cd047efc8a2c2c699311162f2369c17c690e591de16dc8313abd96781d04a09765cb9a049828d
+  metadata.gz: 27a98bbc05db0abaacc9d15dbb164ef342449085882d7e4bf3ca55efd30c9e7dee2514fff942f0d01af7ca93046f642ffab6cb7be616f7bda8984950f05362de
+  data.tar.gz: e4ad9c4bf1d8359843620037c22d9f60e32054936fec48f44020b0520da86f84594fb686f2db9cff4e11cd7e7fc7d30e98051805b04f54da635fc80258136888

data/README.adoc

@@ -4,25 +4,21 @@
 
 :option_parser_link: link:https://alchemists.io/articles/ruby_option_parser[OptionParser]
 :semver_link: link:https://semver.org[Semantic Versioning]
+:strict_semver_link: link:https://alchemists.io/articles/strict_semantic_versioning[Strict Semantic Versioning]
 
 = Versionaire
 
-Ruby doesn't provide a primitive version type by default so Versionaire fills this gap by providing immutable and thread-safe {semver_link} so you can leverage versions within your applications. This new `Version` type behaves and feels a lot like other primitives (i.e. `String`, `Array`, `Hash`, etc) and can even be cast/converted from other primitives.
+Ruby doesn't provide a primitive version type by default so Versionaire fills this gap by providing immutable and thread-safe {strict_semver_link} so you can leverage versions within your applications. This new `Version` type behaves and feels a lot like other primitives (i.e. `String`, `Array`, `Hash`, `Proc`, etc) and can be cast/converted from other primitives.
 
 toc::[]
 
 == Features
 
-* Provides _strict_ {semver_link} which means `<major>.<minor>.<patch>`.
+* Provides {strict_semver_link} which means `<major>.<minor>.<patch>`.
 * Provides immutable, thread-safe version instances.
-* Converts (casts) from a `String`, `Array`, `Hash`, or `Version` to a `Version`.
-* Disallows `<major>.<minor>.<patch>-<pre-release>` usage even though {semver_link} suggests that you _may_ use pre-release information.
-* Disallows `<major>.<minor>.<patch>+<build_metadata>` usage even though {semver_link} suggests that you _may_ use build metadata.
-
-== Screencasts
-
-[link=https://alchemists.io/screencasts/versionaire]
-image::https://alchemists.io/images/screencasts/versionaire/cover.svg[Screencast,600,240,role=focal_point]
+* Converts (casts) from a `String`, `Array`, `Hash`, `Proc`, or `Version` to a `Version`.
+* Disallows `<major>.<minor>.<patch>-<pre-release>` usage even though {semver_link} suggests you _may_ use pre-release information.
+* Disallows `<major>.<minor>.<patch>+<build_metadata>` usage even though {semver_link} suggests you _may_ use build metadata.
 
 == Requirements
 
@@ -139,8 +135,9 @@ Versionaire::Version major: 1, minor: 0, patch: 0
 Versionaire::Version version
 ----
 
-Each of these conversions will result in a version object that represents "`1.0.0`". When attempting
-to convert an unsupported type, a `Versionaire::Error` exception will be thrown.
+Each of these conversions will result in a version object that represents "`1.0.0`".
+
+When attempting to convert an unsupported type, a `Versionaire::Error` exception will be thrown.
 
 ==== Refinement
 
@@ -160,9 +157,8 @@ Version version
 
 By adding `using Versionaire::Cast` to your implementation, this allows Versionaire to refine
 `Kernel` so you have a top-level `Version` conversion function much like Kernel's native support for
-`Integer`, `String`, `Array`, `Hash`, etc. The benefit to this approach is it reduces the amount of
-typing, doesn't pollute your entire object space like a monkey patch would, and provides a idiomatic
-approach to casting like any other primitive.
+`Integer`, `String`, `Array`, `Hash`, etc. The benefit to this approach is to reduce the amount of
+typing so you don't pollute your entire object space, like a monkey patch, while providing an idiomatic approach to casting like any other primitive.
 
 ==== Implicit
 
@@ -187,7 +183,7 @@ version.to_h     # {major: 0, minor: 0, patch: 0}
 version.to_proc  # #<Proc:0x000000010b015b88 (lambda)>
 ----
 
-To elaborate on procs further, this means the following is possible:
+To elaborate on procs, this means the following is possible where you might want to collect all minor verions values or make use of version information in other useful ways:
 
 [source,ruby]
 ----

data/lib/versionaire/function.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
-require "refinements/arrays"
-require "refinements/structs"
+require "refinements/array"
+require "refinements/struct"
 
 # The gem namespace.
 module Versionaire
@@ -22,8 +22,8 @@ module Versionaire
 
   # Aids with converting objects into valid versions.
   class Converter
-    using Refinements::Arrays
-    using Refinements::Structs
+    using Refinements::Array
+    using Refinements::Struct
 
     def initialize object, model: Version
       @object = object
@@ -41,7 +41,7 @@ module Versionaire
       body = "Use: [<major>, <minor>, <patch>], [<major>, <minor>], [<major>], or []."
       fail Error, error_message(object, body) unless (0..3).cover? object.size
 
-      model.with_positions(*object.pad(0, max: 3))
+      model.with_positions(*object.pad(0, 3))
     end
 
     def from_hash
@@ -63,7 +63,7 @@ module Versionaire
     def string_to_version
       object.split(DELIMITER)
             .map(&:to_i)
-            .then { |numbers| numbers.pad 0, max: 3 }
+            .then { |numbers| numbers.pad 0, 3 }
             .then { |arguments| model.with_positions(*arguments) }
     end
 

data/lib/versionaire/version.rb

@@ -1,14 +1,15 @@
 # frozen_string_literal: true
 
-require "refinements/structs"
+require "refinements/array"
+require "refinements/struct"
 
 module Versionaire
   # An immutable, semantic version value object.
   Version = Struct.new :major, :minor, :patch, keyword_init: true do
     include Comparable
 
-    using Refinements::Arrays
-    using Refinements::Structs
+    using Refinements::Array
+    using Refinements::Struct
 
     def initialize major: 0, minor: 0, patch: 0
       super

data/versionaire.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |spec|
   spec.name = "versionaire"
-  spec.version = "12.1.1"
+  spec.version = "13.1.0"
   spec.authors = ["Brooke Kuhlmann"]
   spec.email = ["brooke@alchemists.io"]
   spec.homepage = "https://alchemists.io/projects/versionaire"
@@ -22,8 +22,8 @@ Gem::Specification.new do |spec|
   spec.signing_key = Gem.default_key_path
   spec.cert_chain = [Gem.default_cert_path]
 
-  spec.required_ruby_version = [">= 3.2", "<= 3.3"]
-  spec.add_dependency "refinements", "~> 11.0"
+  spec.required_ruby_version = "~> 3.3"
+  spec.add_dependency "refinements", "~> 12.0"
 
   spec.files = Dir["*.gemspec", "lib/**/*"]
   spec.extra_rdoc_files = Dir["README*", "LICENSE*"]

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: versionaire
 version: !ruby/object:Gem::Version
-  version: 12.1.1
+  version: 13.1.0
 platform: ruby
 authors:
 - Brooke Kuhlmann
@@ -35,7 +35,7 @@ cert_chain:
   3n5C8/6Zh9DYTkpcwPSuIfAga6wf4nXc9m6JAw8AuMLaiWN/r/2s4zJsUHYERJEu
   gZGm4JqtuSg8pYjPeIJxS960owq+SfuC+jxqmRA54BisFCv/0VOJi7tiJVY=
   -----END CERTIFICATE-----
-date: 2023-11-16 00:00:00.000000000 Z
+date: 2024-02-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: refinements
@@ -43,14 +43,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '11.0'
+        version: '12.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '11.0'
+        version: '12.0'
 description:
 email:
 - brooke@alchemists.io
@@ -86,10 +86,7 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
-    - !ruby/object:Gem::Version
-      version: '3.2'
-  - - "<="
+  - - "~>"
     - !ruby/object:Gem::Version
       version: '3.3'
 required_rubygems_version: !ruby/object:Gem::Requirement
@@ -98,7 +95,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.22
+rubygems_version: 3.5.6
 signing_key:
 specification_version: 4
 summary: An immutable, thread-safe, and semantic version type.