gitlab-releases 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '012839858bf2b4667e097db4a1f41483c6b1de81079b0d6b66a8c0ca3f79caec'
-  data.tar.gz: 945ef3fa1e38276db5ade3304bbcfab1ad43f5f292a3bd48080fb34489094e3c
+  metadata.gz: 1f9a73b90b46892ca18e3a95eba76136dd3d1f55e8c0eec56a39068076b1e4b3
+  data.tar.gz: d82099b7bf7cd5d0761e8c5b538df4628d8e754127858a8e18d03d94fb03dbcc
 SHA512:
-  metadata.gz: 5562b8c72e43d208a401087c8d63e1d6ac20d01cd8f2674d0112903cce5ef5174203b3427110c975c157f03fde7a97dfcccf0a1efbc2e56377ac86785a9397ee
-  data.tar.gz: 0b1b5a0589b7b727e1b9abfa780983ca8621a27b3e2599561e83f65e6a3281e85d09bc402c54d0a4f030b707f0c8a6bb52ecc0cc34d39ddd3fea38a1a38b7d5f
+  metadata.gz: aefa80ca4044fee1975419c938eb174c326c0bbfd7b662c89af5f2d6695ad4affb94391fba49e74f90d375e68d26bb6878425e133b2837258f09d88ce09472a3
+  data.tar.gz: 8d13eaea034f5682daba9d8de01ca5d42bcdd921fdc93ca64b23b9037bb3c41fae759aaf7da3be4c7f58283c8657bf603fca34b066f0f5b70d12b3a589b77978

data/CHANGELOG.md

@@ -1,64 +1,73 @@
-## [0.1.0] - 2023-08-01
+## [Unreleased]
 
-- Initial release. Starting with 16.6, GitLab monthly release date will be moved from the 22nd to the 3rd Thursday of each month, this gem automatically calculates the release dates and the associated version for 12 months in advance.
+## [1.1.0] - 2025-03-04
 
-## [0.1.1] - 2023-08-21
+- Add `latest_patch_for_version` method to retrieve the latest patch for a given minor version
 
-- Gem renamed to `releases` to account for new utility methods included (`active_version`,  `current_version`, `next_versions`)
+## [1.0.1] - 2024-11-20
 
-## [0.1.2] - 2023-08-22
+- Upgrade gitlab gem to 5.1
+- Upgrade activesupport gem to 8.0
+
+## [1.0.0] - 2024-07-04
+
+- Upgrade Ruby to 3.3.1
+- Upgrade gitlab gem to 4.20.1
+- Add runbook for publishing new versions of this gem
+
+## [0.2.9] - 2024-04-18
+
+- Fixes `ReleaseCalculator` class to consider major milestones.
+
+## [0.2.8]
 
 - Yanked version
 
-## [0.1.3] - 2023-08-22
+## [0.2.7] - 2024-03-06
 
-- `version_for_date` and `previous_version` methods included.
+- Add `next_patch_release_date` method to return the next best-effort date for patch releases
 
-## [0.2.0] - 2023-08-31
+## [0.2.6] - 2024-02-22
 
-- Gem renamed to `gitlab-releases` to align with GitLab gem naming conventions
-- PRODUCTION_TOKEN renamed to RELEASES_GITLAB_READ_TOKEN
+- Add `available_versions` method to return the available GitLab versions (sorted by most recent)
 
-## [0.2.1] - 2023-09-25
+## [0.2.5] - 2023-11-23
 
-- `GitlabReleases.active_version` was updated to consider dates equal than the date provided. This mirrors the logic used in release-tools.
+- Add methods to calculate the current version of a given date (`#current_minor_for_date`) and the previous minors for a specific version (`#previous_minors`)
 
-## [0.2.2] - 2023-10-02
+## [0.2.4] - 2023-11-03
 
-- Fixed `previous_version` to return the latest patch of the previous minor version.
+- Remove logic for static release date. All release dates will be calculated based on the third Thursday of the month.
 
 ## [0.2.3] - 2023-10-11
 
 - Update ActiveSupport gem and loosen version restriction
 
-## [0.2.4] - 2023-11-03
+## [0.2.2] - 2023-10-02
 
-- Remove logic for static release date. All release dates will be calculated based on the third Thursday of the month.
+- Fixed `previous_version` to return the latest patch of the previous minor version.
 
-## [0.2.5] - 2023-11-23
+## [0.2.1] - 2023-09-25
 
-- Add methods to calculate the current version of a given date (`#current_minor_for_date`) and the previous minors for a specific version (`#previous_minors`)
+- `GitlabReleases.active_version` was updated to consider dates equal than the date provided. This mirrors the logic used in release-tools.
 
-## [0.2.6] - 2024-02-22
+## [0.2.0] - 2023-08-31
 
-- Add `available_versions` method to return the available GitLab versions (sorted by most recent)
+- Gem renamed to `gitlab-releases` to align with GitLab gem naming conventions
+- PRODUCTION_TOKEN renamed to RELEASES_GITLAB_READ_TOKEN
 
-## [0.2.7] - 2024-03-06
+## [0.1.3] - 2023-08-22
 
-- Add `next_patch_release_date` method to return the next best-effort date for patch releases
+- `version_for_date` and `previous_version` methods included.
 
-## [0.2.8]
+## [0.1.2] - 2023-08-22
 
 - Yanked version
 
-## [0.2.9] - 2024-04-18
-
-- Fixes `ReleaseCalculator` class to consider major milestones.
+## [0.1.1] - 2023-08-21
 
-## [1.0.0] - 2024-07-04
+- Gem renamed to `releases` to account for new utility methods included (`active_version`,  `current_version`, `next_versions`)
 
-- Upgrade Ruby to 3.3.1
-- Upgrade gitlab gem to 4.20.1
-- Add runbook for publishing new versions of this gem
+## [0.1.0] - 2023-08-01
 
-## [Unreleased]
+- Initial release. Starting with 16.6, GitLab monthly release date will be moved from the 22nd to the 3rd Thursday of each month, this gem automatically calculates the release dates and the associated version for 12 months in advance.

data/Gemfile

@@ -5,8 +5,8 @@ source 'https://rubygems.org'
 # Specify your gem's dependencies in gitlab-releases.gemspec
 gemspec
 
-gem 'activesupport', '~> 7.1'
-gem 'gitlab', '~> 4.20.1'
+gem 'activesupport', '~> 8.0'
+gem 'gitlab', '~> 5.1'
 gem 'http', '~> 5.2.0'
 gem 'rake', '~> 13.0'
 gem 'retriable', '~> 3.1.2'

data/Gemfile.lock

@@ -1,9 +1,9 @@
 PATH
   remote: .
   specs:
-    gitlab-releases (1.0.0)
-      activesupport (~> 7.1)
-      gitlab (~> 4.20.1)
+    gitlab-releases (1.1.0)
+      activesupport (~> 8.0)
+      gitlab (~> 5.1)
       http (~> 5.2.0, ~> 5.2)
       retriable (~> 3.1.2)
       version_sorter (~> 2.3.0)
@@ -11,25 +11,29 @@ PATH
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (7.1.3.4)
+    activesupport (8.0.0)
       base64
+      benchmark (>= 0.3)
       bigdecimal
-      concurrent-ruby (~> 1.0, >= 1.0.2)
+      concurrent-ruby (~> 1.0, >= 1.3.1)
       connection_pool (>= 2.2.5)
       drb
       i18n (>= 1.6, < 2)
+      logger (>= 1.4.2)
       minitest (>= 5.1)
-      mutex_m
-      tzinfo (~> 2.0)
+      securerandom (>= 0.3)
+      tzinfo (~> 2.0, >= 2.0.5)
+      uri (>= 0.13.1)
     addressable (2.8.6)
       public_suffix (>= 2.0.2, < 6.0)
     ast (2.4.2)
     base64 (0.2.0)
+    benchmark (0.4.0)
     bigdecimal (3.1.8)
     binding_of_caller (1.0.1)
       debug_inspector (>= 1.2.0)
     coderay (1.1.3)
-    concurrent-ruby (1.3.3)
+    concurrent-ruby (1.3.4)
     connection_pool (2.4.1)
     crack (1.0.0)
       bigdecimal
@@ -42,10 +46,12 @@ GEM
     ffi (1.17.0)
     ffi (1.17.0-arm64-darwin)
     ffi (1.17.0-x86_64-darwin)
+    ffi (1.17.0-x86_64-linux-gnu)
     ffi-compiler (1.3.2)
       ffi (>= 1.15.5)
       rake
-    gitlab (4.20.1)
+    gitlab (5.1.0)
+      base64 (~> 0.2.0)
       httparty (~> 0.20)
       terminal-table (>= 1.5.1)
     hashdiff (1.1.0)
@@ -62,19 +68,19 @@ GEM
       csv
       mini_mime (>= 1.0.0)
       multi_xml (>= 0.5.2)
-    i18n (1.14.5)
+    i18n (1.14.6)
       concurrent-ruby (~> 1.0)
     json (2.7.2)
     language_server-protocol (3.17.0.3)
     llhttp-ffi (0.5.0)
       ffi-compiler (~> 1.0)
       rake (~> 13.0)
+    logger (1.6.1)
     method_source (1.1.0)
     mini_mime (1.1.5)
-    minitest (5.24.0)
+    minitest (5.25.1)
     multi_xml (0.7.1)
       bigdecimal (~> 3.1)
-    mutex_m (0.2.0)
     parallel (1.25.1)
     parser (3.3.3.0)
       ast (~> 2.4.1)
@@ -133,6 +139,7 @@ GEM
     rubocop-ast (1.31.3)
       parser (>= 3.3.1.0)
     ruby-progressbar (1.13.0)
+    securerandom (0.3.2)
     strscan (3.1.0)
     terminal-table (3.0.2)
       unicode-display_width (>= 1.1.1, < 3)
@@ -143,6 +150,7 @@ GEM
     unparser (0.6.15)
       diff-lcs (~> 1.3)
       parser (>= 3.3.0)
+    uri (1.0.2)
     vcr (6.2.0)
     version_sorter (2.3.0)
     webmock (3.18.1)
@@ -157,10 +165,11 @@ PLATFORMS
   ruby
   x86_64-darwin-20
   x86_64-darwin-22
+  x86_64-linux
 
 DEPENDENCIES
-  activesupport (~> 7.1)
-  gitlab (~> 4.20.1)
+  activesupport (~> 8.0)
+  gitlab (~> 5.1)
   gitlab-releases!
   http (~> 5.2.0)
   pry (~> 0.14.0)

data/README.md

@@ -12,7 +12,7 @@ Library to interact with GitLab releases and versions. The information is fetche
 Gemfile:
 
 ```
-gem 'gitlab-releases', '~> 1.0.0'
+gem 'gitlab-releases', '~> 1.1.0'
 ```
 
 Install:
@@ -35,11 +35,12 @@ There are different methods available:
 * `active_version`  - Returns the active GitLab version.
 * `current_version` - Returns the current GitLab minor version.
 * `next_versions` - Returns the next GitLab patch versions (for patch and security releases).
-* `previous_version` - Returns the return the latest patch of the previous minor version.
+* `previous_version` - Returns the latest patch of the previous minor version.
 * `version_for_date` - Returns the active GitLab version for the given date
 * `current_minor_for_date` - Returns the current GitLab minor for the given date
 * `previous_minors` - Returns the previous minors for the given version
 * `next_patch_release_date` - Calculates the next best effort date for a GitLab patch release.
+* `latest_patch_for_version` - Returns the latest patch for the given minor version
 
 To make use of it:
 
@@ -83,6 +84,8 @@ To make use of it:
 => ["16.6", "16.5", "16.4"]
 > GitlabReleases.next_patch_release_date
 => "2024-03-13"
+> GitlabReleases.latest_patch_for_version('16.6')
+=> "16.6.10"
 
 ```
 
@@ -103,4 +106,4 @@ The gem is available as open source under the terms of the [MIT License](https:/
 Everyone interacting in the Releases project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://gitlab.com/gitlab-org/ruby/gems/gitlab-releases/-/blob/main/CODE_OF_CONDUCT.md).
 
 [Delivery team tracker]: https://gitlab.com/gitlab-com/gl-infra/delivery
-[Releases documentation]: https://gitlab.com/gitlab-org/ruby/gems/gitlab-releases/-/blob/master/docs/releases.md
+[Releases documentation]: https://gitlab.com/gitlab-org/ruby/gems/gitlab-releases/-/blob/main/docs/releases.md

data/lib/gitlab_releases/release_versions.rb

@@ -155,6 +155,19 @@ class ReleaseVersions
     next_versions.second.previous_patch
   end
 
+  # Returns the latest patch for a given minor version
+  #
+  # For example:
+  # - If the given version is 16.7 and available versions include 16.7.0, 16.7.1, 16.7.2
+  #   it will return 16.7.2
+  # - If the given version is 16.5 and available versions include 16.5.0, 16.5.1
+  #   it will return 16.5.1
+  def self.latest_patch_for_version(version)
+    minor_version = ReleaseVersion.new(version).to_minor
+
+    available_versions.find { |v| v.start_with?("#{minor_version}.") }
+  end
+
   def self.sort(versions)
     ::VersionSorter.sort(versions).uniq
   end

data/lib/gitlab_releases/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module GitlabReleases
-  VERSION = "1.0.0"
+  VERSION = "1.1.0"
 end

data/lib/gitlab_releases.rb

@@ -54,5 +54,9 @@ module GitlabReleases
     ReleaseVersions.previous_release_date
   end
 
+  def self.latest_patch_for_version(version)
+    ReleaseVersions.latest_patch_for_version(version)
+  end
+
   private_class_method :release_date
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: gitlab-releases
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Mayra Cabrera
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-07-04 00:00:00.000000000 Z
+date: 2025-03-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -16,28 +16,28 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '7.1'
+        version: '8.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '7.1'
+        version: '8.0'
 - !ruby/object:Gem::Dependency
   name: gitlab
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 4.20.1
+        version: '5.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 4.20.1
+        version: '5.1'
 - !ruby/object:Gem::Dependency
   name: http
   requirement: !ruby/object:Gem::Requirement
@@ -86,7 +86,7 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 2.3.0
-description: 
+description:
 email:
 - mcabrera@gitlab.com
 executables: []
@@ -121,7 +121,7 @@ metadata:
   homepage_uri: https://gitlab.com/gitlab-org/ruby/gems/gitlab-releases
   source_code_uri: https://gitlab.com/gitlab-org/ruby/gems/gitlab-releases
   changelog_uri: https://gitlab.com/gitlab-org/ruby/gems/gitlab-releases/-/blob/main/CHANGELOG.md
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -137,7 +137,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubygems_version: 3.5.9
-signing_key: 
+signing_key:
 specification_version: 4
 summary: Utilities for GitLab releases and versions
 test_files: []