gitlab-releases 0.2.4 → 0.2.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 96b0b12edaa3ab669ff5b01e2a3ad8a699321aaec1fe1d8ba52be69db6de9e59
-  data.tar.gz: b4e78d554defe39d5a06d4d10d92b4d48e55ef9371ffe7823a7090620a9f6a5f
+  metadata.gz: e2128d5d1e5b1c5d79f06479831fcac6c60e00cc490a65baf93c4d8066154a47
+  data.tar.gz: 60fdbd787c8ad353e52d442c6830ac56428622f5d65b36fb7e6cccaa2de8923a
 SHA512:
-  metadata.gz: 6e52f6976faa23b62f28edefe9fa660f138e7eb8bbd9e3b0b143152c1e727da934c73234ece5edf112151caf9020ae1da806fae5f5f64a5dbbe6a4f16fa9ca85
-  data.tar.gz: 404e69849913a99274acbfc016af7f0f4beca48b5cd176f8bc9fd6d2d7c9fc7147c6fc3d1c542a5cc46ec5c63530bf467c4a2eae167b1fe4073347094ba4c5a7
+  metadata.gz: ffb780317bd4ada84fdb7312380049ac5e3baee5662742ca1efdeb74cfd613932c76025b26c7c767e5709ead7f07a89100d39d7c0e16b3657dce682ad50d2369
+  data.tar.gz: 35f7c73a835b18097568b403f8a3232a302d3714c12d121d1760dc642fe45ed92e4b67566994b10e2b063a92188afc7e13dc49033906a01aa093874ff88184b7

data/.ruby-version

@@ -0,0 +1 @@
+3.0.0

data/CHANGELOG.md

@@ -36,3 +36,11 @@
 ## [0.2.4] - 2023-11-03
 
 - Remove logic for static release date. All release dates will be calculated based on the third Thursday of the month.
+
+## [0.2.5] - 2023-11-23
+
+- 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.6] - 2024-02-22
+
+- Add `available_versions` method to return the available GitLab versions (sorted by most recent)

data/Gemfile

@@ -7,7 +7,7 @@ gemspec
 
 gem 'activesupport', '~> 7.1'
 gem 'gitlab', '~> 4.19.0'
-gem 'http', '~> 5.1.0'
+gem 'http', '~> 5.1.1'
 gem 'rake', '~> 13.0'
 gem 'retriable', '~> 3.1.2'
 gem 'version_sorter', '~> 2.3.0'

data/Gemfile.lock

@@ -1,17 +1,17 @@
 PATH
   remote: .
   specs:
-    gitlab-releases (0.2.3)
+    gitlab-releases (0.2.6)
       activesupport (~> 7.1)
       gitlab (~> 4.19.0)
-      http (~> 5.1.0)
+      http (~> 5.1.1, ~> 5.1)
       retriable (~> 3.1.2)
       version_sorter (~> 2.3.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (7.1.0)
+    activesupport (7.1.3.2)
       base64
       bigdecimal
       concurrent-ruby (~> 1.0, >= 1.0.2)
@@ -21,32 +21,32 @@ GEM
       minitest (>= 5.1)
       mutex_m
       tzinfo (~> 2.0)
-    addressable (2.8.5)
+    addressable (2.8.6)
       public_suffix (>= 2.0.2, < 6.0)
     ast (2.4.2)
-    base64 (0.1.1)
-    bigdecimal (3.1.4)
+    base64 (0.2.0)
+    bigdecimal (3.1.6)
     binding_of_caller (1.0.0)
       debug_inspector (>= 0.0.1)
     coderay (1.1.3)
-    concurrent-ruby (1.2.2)
+    concurrent-ruby (1.2.3)
     connection_pool (2.4.1)
-    crack (0.4.5)
+    crack (1.0.0)
+      bigdecimal
       rexml
-    debug_inspector (1.1.0)
-    diff-lcs (1.5.0)
-    domain_name (0.5.20190701)
-      unf (>= 0.0.5, < 1.0.0)
-    drb (2.1.1)
+    debug_inspector (1.2.0)
+    diff-lcs (1.5.1)
+    domain_name (0.6.20240107)
+    drb (2.2.0)
       ruby2_keywords
-    ffi (1.15.5)
+    ffi (1.16.3)
     ffi-compiler (1.0.1)
       ffi (>= 1.0.0)
       rake
     gitlab (4.19.0)
       httparty (~> 0.20)
       terminal-table (>= 1.5.1)
-    hashdiff (1.0.1)
+    hashdiff (1.1.0)
     http (5.1.1)
       addressable (~> 2.8)
       http-cookie (~> 1.0)
@@ -60,18 +60,18 @@ GEM
       multi_xml (>= 0.5.2)
     i18n (1.14.1)
       concurrent-ruby (~> 1.0)
-    json (2.6.3)
+    json (2.7.1)
     language_server-protocol (3.17.0.3)
     llhttp-ffi (0.4.0)
       ffi-compiler (~> 1.0)
       rake (~> 13.0)
     method_source (1.0.0)
-    mini_mime (1.1.2)
-    minitest (5.20.0)
+    mini_mime (1.1.5)
+    minitest (5.22.2)
     multi_xml (0.6.0)
-    mutex_m (0.1.2)
-    parallel (1.23.0)
-    parser (3.2.2.3)
+    mutex_m (0.2.0)
+    parallel (1.24.0)
+    parser (3.3.0.5)
       ast (~> 2.4.1)
       racc
     proc_to_ast (0.1.0)
@@ -81,25 +81,25 @@ GEM
     pry (0.14.2)
       coderay (~> 1.1)
       method_source (~> 1.0)
-    public_suffix (5.0.3)
-    racc (1.7.1)
+    public_suffix (5.0.4)
+    racc (1.7.3)
     rainbow (3.1.1)
-    rake (13.0.6)
-    regexp_parser (2.8.1)
+    rake (13.1.0)
+    regexp_parser (2.9.0)
     retriable (3.1.2)
     rexml (3.2.6)
-    rspec (3.12.0)
-      rspec-core (~> 3.12.0)
-      rspec-expectations (~> 3.12.0)
-      rspec-mocks (~> 3.12.0)
-    rspec-core (3.12.2)
-      rspec-support (~> 3.12.0)
-    rspec-expectations (3.12.3)
+    rspec (3.13.0)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.0)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.0)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.12.0)
-    rspec-mocks (3.12.6)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.0)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.12.0)
+      rspec-support (~> 3.13.0)
     rspec-parameterized (1.0.0)
       rspec-parameterized-core (< 2)
       rspec-parameterized-table_syntax (< 2)
@@ -108,22 +108,22 @@ GEM
       proc_to_ast
       rspec (>= 2.13, < 4)
       unparser
-    rspec-parameterized-table_syntax (1.0.0)
+    rspec-parameterized-table_syntax (1.0.1)
       binding_of_caller
       rspec-parameterized-core (< 2)
-    rspec-support (3.12.1)
-    rubocop (1.55.1)
+    rspec-support (3.13.1)
+    rubocop (1.60.2)
       json (~> 2.3)
       language_server-protocol (>= 3.17.0)
       parallel (~> 1.10)
-      parser (>= 3.2.2.3)
+      parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
       regexp_parser (>= 1.8, < 3.0)
       rexml (>= 3.2.5, < 4.0)
-      rubocop-ast (>= 1.28.1, < 2.0)
+      rubocop-ast (>= 1.30.0, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 3.0)
-    rubocop-ast (1.29.0)
+    rubocop-ast (1.30.0)
       parser (>= 3.2.1.0)
     ruby-progressbar (1.13.0)
     ruby2_keywords (0.0.5)
@@ -132,13 +132,10 @@ GEM
     timecop (0.9.8)
     tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
-    unf (0.1.4)
-      unf_ext
-    unf_ext (0.0.8.2)
-    unicode-display_width (2.4.2)
-    unparser (0.6.8)
+    unicode-display_width (2.5.0)
+    unparser (0.6.13)
       diff-lcs (~> 1.3)
-      parser (>= 3.2.0)
+      parser (>= 3.3.0)
     vcr (6.2.0)
     version_sorter (2.3.0)
     webmock (3.18.1)
@@ -149,13 +146,16 @@ GEM
 PLATFORMS
   arm64-darwin-21
   arm64-darwin-22
+  arm64-darwin-23
+  ruby
+  x86_64-darwin-20
   x86_64-darwin-22
 
 DEPENDENCIES
   activesupport (~> 7.1)
   gitlab (~> 4.19.0)
   gitlab-releases!
-  http (~> 5.1.0)
+  http (~> 5.1.1)
   pry (~> 0.14.0)
   rake (~> 13.0)
   retriable (~> 3.1.2)
@@ -168,4 +168,4 @@ DEPENDENCIES
   webmock (~> 3.18.0)
 
 BUNDLED WITH
-   2.3.25
+   2.5.6

data/README.md

@@ -12,7 +12,7 @@ Library to interact with GitLab releases and versions. The information is fetche
 Gemfile:
 
 ```
-gem 'gitlab-releases', '~> 0.2.4'
+gem 'gitlab-releases', '~> 0.2.5'
 ```
 
 Install:
@@ -36,6 +36,9 @@ There are different methods available:
 * `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.
+* `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
 
 To make use of it:
 
@@ -69,6 +72,14 @@ To make use of it:
 => ["16.5.2", "16.4.3", "16.3.7"]
 > GitlabReleases.previous_version
 => "16.4.2"
+> GitlabReleases.available_versions
+=> ["16.4.1", "16.4.0", "16.3.5", "16.3.4", ...] # Up to 50 versions
+> GitlabReleases.version_for_date('2023-11-23')
+=> "16.7"
+> GitlabReleases.current_minor_for_date('2023-11-23')
+=> "16.6"
+> GitlabReleases.previous_minors('16.6')
+=> ["16.6", "16.5", "16.4"]
 ```
 
 ## Contributing

data/lib/gitlab_releases/release_versions.rb

@@ -54,6 +54,16 @@ class ReleaseVersions
     end.take(count)
   end
 
+  # Returns the available GitLab versions as an Array
+  #
+  # Example:
+  #
+  #   available_versions
+  #   => ['1.2.3', '1.1.1', '1.0.0']
+  def self.available_versions
+    ::VersionSorter.rsort(current_list)
+  end
+
   # Returns the current GitLab minor version
   def self.current_version
     ReleaseVersion.new(next_versions.first.to_minor)
@@ -75,8 +85,8 @@ class ReleaseVersions
 
   # Returns the scheduled major.minor for the given date
   def self.version_for_date(date)
-    # Returns the release associated with the date by calling `releases_yaml` and fetching the
-    # release whose date is greater than the given date.
+    # Returns the active release associated with the date by calling `releases_yaml` and fetching the
+    # release whose date is greater or equal than the given date.
     #
     # For example:
     #
@@ -99,6 +109,34 @@ class ReleaseVersions
     ReleaseVersion.new(row['version'])
   end
 
+  # Returns the current major.minor for the given date
+  def self.current_minor_for_date(date)
+    # Returns the current version associated with the date by calling `releases_yaml`
+    # and fetching the version whose release date is less or equal to the given date.
+    #
+    # For example:
+    #
+    # | Version | Date           |
+    # |:--------|:---------------|
+    # | 16.3    | August 22nd    |
+    # | 16.4    | September 22nd |
+    # | 16.5    | October 22nd   |
+    # | 16.6    | November 16th  |
+    # | 16.7    | December 21st  |
+    #
+    # * For August 21st, the release should be 16.2
+    # * For August 22nd, the release should be 16.3
+    # * For August 23rd, the release should be 16.3
+    # * For November 17th, the release should be 16.6
+    return nil if releases_yaml.empty?
+
+    row = releases_yaml
+      .reverse
+      .detect { |release| date.to_date >= release['date'] }
+
+    ReleaseVersion.new(row['version'])
+  end
+
   # Returns the last patch of the previous minor version
   #
   # For example, if the current version is 16.4, then
@@ -114,6 +152,19 @@ class ReleaseVersions
     ::VersionSorter.sort(versions).uniq
   end
 
+  # Returns the previous major.minor versions of the major.minor version based on the
+  # releases.yml data
+  #
+  # For example:
+  # - If the current version is 16.7, the previous patch versions are 16.7, 16.6, and 16.5
+  # - If the current version is 17.1, the previous patch versions are 17.1, 16.11, and 16.10
+  def self.previous_minors(version)
+    versions = releases_yaml.map { |release| release['version'] }
+      .reverse
+
+    versions[versions.index(version), 3]
+  end
+
   def self.raw_versions
     ReleaseVersionClient.versions
   end

data/lib/gitlab_releases/version.rb

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

data/lib/gitlab_releases.rb

@@ -33,6 +33,18 @@ module GitlabReleases
     ReleaseVersions.previous_version
   end
 
+  def self.current_minor_for_date(date)
+    ReleaseVersions.current_minor_for_date(date)
+  end
+
+  def self.previous_minors(version)
+    ReleaseVersions.previous_minors(version)
+  end
+
+  def self.available_versions
+    ReleaseVersions.available_versions
+  end
+
   def self.release_date
     ReleaseVersions.previous_release_date
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: gitlab-releases
 version: !ruby/object:Gem::Version
-  version: 0.2.4
+  version: 0.2.6
 platform: ruby
 authors:
 - Mayra Cabrera
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-11-03 00:00:00.000000000 Z
+date: 2024-02-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -44,14 +44,20 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 5.1.0
+        version: '5.1'
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 5.1.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 5.1.0
+        version: '5.1'
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 5.1.1
 - !ruby/object:Gem::Dependency
   name: retriable
   requirement: !ruby/object:Gem::Requirement
@@ -89,6 +95,7 @@ extra_rdoc_files: []
 files:
 - ".rspec"
 - ".rubocop.yml"
+- ".ruby-version"
 - CHANGELOG.md
 - CODE_OF_CONDUCT.md
 - Gemfile
@@ -127,7 +134,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.17
+rubygems_version: 3.2.3
 signing_key:
 specification_version: 4
 summary: Utilities for GitLab releases and versions