releases 0.1.1 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 40847d20ecf623f40ac43ae4516a987dfef492623cae863d4d3869da565ae024
-  data.tar.gz: 0124b51e8f546abd13421a3449738355d2133e94c8e6108c610a3b72b91eb519
+  metadata.gz: b3045a4bf992cb95e413e0d9b966d25180124bf8213142aa80271537cfabe72d
+  data.tar.gz: c16860e87255020ba3399374572afc1739f151ac9a5a2871ae4061e7f336c7d4
 SHA512:
-  metadata.gz: 571b2bc56190f62c43f5aa9eb4580fbc6190d6618f5efd62cb7be4854664901fdc604fea2d0726c8df06ed11840f03b46a1d110794852ff0129b22f77940f3c5
-  data.tar.gz: 9558687db01e04b2da6879b0d350a7e1e087bed31108bf100fb1593a9ebbb109455c8473433508ebe27041fc84405718a8b9e09fe3d18d3b9621ac543f12dbf7
+  metadata.gz: ea7d01bef315ddb956caf4e991a2483f62df91e26d08d20c7f1bf01762eaa68b6089a66d6fa4b258da4d2b1d42507d4c9355791314119eb052e3051e7a4be335
+  data.tar.gz: d54108a88c9c1a2a6a0512704a7a7e7e8a4dc5b73ef726e41185834a20b08bd46f800e97b0c1c4d4a175709039b5428e6222b5e8ebcfe071230d1835f18a2f59

data/CHANGELOG.md

@@ -2,4 +2,16 @@
 
 ## [0.1.0] - 2023-08-01
 
-- Initial release
+- 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.
+
+## [0.1.1] - 2023-08-21
+
+- Gem renamed to `releases` to account for new utility methods included (`active_version`,  `current_version`, `next_versions`)
+
+## [0.1.2] - 2023-08-22
+
+- Yanked version
+
+## [0.1.3] - 2023-08-22
+
+- `version_for_date` and `previous_version` methods included.

data/Gemfile

@@ -17,6 +17,7 @@ group :development, :test do
   gem 'rspec', '~> 3.0'
   gem 'rspec-parameterized', '>= 1.0.0'
   gem 'rubocop', '~> 1.21'
+  gem 'timecop', '~> 0.9.0'
   gem 'vcr', '~> 6.2.0'
   gem 'webmock', '~> 3.18.0'
 end

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    releases (0.2.0)
+    releases (0.1.1)
       activesupport (~> 7.0.0)
       gitlab (~> 4.19.0)
       http (~> 5.1.0)
@@ -117,6 +117,7 @@ GEM
     ruby-progressbar (1.13.0)
     terminal-table (3.0.2)
       unicode-display_width (>= 1.1.1, < 3)
+    timecop (0.9.8)
     tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
     unf (0.1.4)
@@ -147,6 +148,7 @@ DEPENDENCIES
   rspec (~> 3.0)
   rspec-parameterized (>= 1.0.0)
   rubocop (~> 1.21)
+  timecop (~> 0.9.0)
   vcr (~> 6.2.0)
   version_sorter (~> 2.3.0)
   webmock (~> 3.18.0)

data/README.md

@@ -1,25 +1,37 @@
-[![Gem Version](https://badge.fury.io/rb/release_dates.svg)](https://badge.fury.io/rb/release_dates)
+[![Gem Version](https://badge.fury.io/rb/releases.svg)](https://badge.fury.io/rb/releases)
 
-# Release Dates
+# Releases
 
-Library to calculate the relative dates for the releases. 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.
+Library to interact with GitLab releases and versions. The information is fetched from two sources:
+
+1. [versions.gitlab.com](https://version.gitlab.com/)
+1. [`releases.yml`](https://gitlab.com/gitlab-com/www-gitlab-com/-/blob/master/data/releases.yml)
 
 ## Installation
 
 ```
-$ gem install release_dates
+$ gem install releases
 ```
 
 ## Usage
 
+There are different methods available:
+
+* `upcoming_releases` - Returns the GitLab release date and the associated version for the next 12 months.
+* `active_version`  - Returns the active GitLab version.
+* `current_version` - Returns the current GitLab version.
+* `next_versions` - Returns the next GitLab patch versions (for patch and security releases).
+
+To make use of it:
+
 1. Create a personal access token with `read_api` scope.
 1. Store it under `PRODUCTION_TOKEN`
 1. Open up an irb session:
 
 ```ruby
-$ require 'release_dates'
-
-$ ReleaseDates.execute
+> require 'releases'
+> releases = Releases
+> releases.upcoming_releases
 =>
 {"16.2"=>"2023-07-22",
  "16.3"=>"2023-08-22",
@@ -34,11 +46,18 @@ $ ReleaseDates.execute
  "17.0"=>"2024-05-16",
  "17.1"=>"2024-06-20",
  "17.2"=>"2024-07-18"}
+
+> releases.active_version
+=> "16.3"
+> releases.current_version
+=> "16.2"
+> releases.next_versions
+=> ["16.2.5", "16.1.5", "16.0.9"]
 ```
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitLub at https://gitlab.com/gitlab-org/delivery/release_dates. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://gitlab.com/gitlab-org/delivery/release_dates/blob/main/CODE_OF_CONDUCT.md).
+Bug reports and pull requests are welcome on GitLab at https://gitlab.com/gitlab-org/delivery/releases. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://gitlab.com/gitlab-org/delivery/releases/blob/main/CODE_OF_CONDUCT.md).
 
 ## License
 
@@ -46,4 +65,4 @@ The gem is available as open source under the terms of the [MIT License](https:/
 
 ## Code of Conduct
 
-Everyone interacting in the ReleaseDates project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://gitlab.com/gitlab-org/delivery/release_dates/main/CODE_OF_CONDUCT.md).
+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/delivery/releases/main/CODE_OF_CONDUCT.md).

data/lib/releases/release_versions.rb

@@ -54,7 +54,7 @@ class ReleaseVersions
     end.take(count)
   end
 
-  # Returns the current GitLab version
+  # Returns the current GitLab minor version
   def self.current_version
     ReleaseVersion.new(next_versions.first.to_minor)
   end
@@ -68,7 +68,7 @@ class ReleaseVersions
     Date.parse(date)
   end
 
-  # Returns the active version of GitLab
+  # Returns the active minor GitLab Version
   def self.active_version
     version_for_date(DateTime.now)
   end
@@ -99,6 +99,21 @@ class ReleaseVersions
     ReleaseVersion.new(row['version'])
   end
 
+  # Returns the N-1 version supported based on the current_list
+  #
+  # For example:
+  # => current_list
+  # => ["16.3.0",  "16.2.4",  "16.1.4", "16.2.3"]
+  # => previous_version
+  # => ['16.2.4']
+  def self.previous_version
+    ReleaseVersion.new(sort(current_list).reverse[1])
+  end
+
+  def self.sort(versions)
+    ::VersionSorter.sort(versions).uniq
+  end
+
   def self.raw_versions
     ReleaseVersionClient.versions
   end

data/lib/releases/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Releases
-  VERSION = "0.1.1"
+  VERSION = "0.1.3"
 end

data/lib/releases.rb

@@ -21,10 +21,18 @@ module Releases
     ReleaseVersions.active_version
   end
 
+  def self.version_for_date(date)
+    ReleaseVersions.version_for_date(date)
+  end
+
   def self.next_versions
     ReleaseVersions.next_versions
   end
 
+  def self.previous_version
+    ReleaseVersions.previous_version
+  end
+
   def self.release_date
     ReleaseVersions.previous_release_date
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: releases
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.3
 platform: ruby
 authors:
 - Mayra Cabrera
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-08-21 00:00:00.000000000 Z
+date: 2023-08-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -110,8 +110,8 @@ licenses:
 - MIT
 metadata:
   homepage_uri: https://gitlab.com/gitlab-org/delivery/releases
-  source_code_uri: https://gitlab.com/groups/gitlab-org/delivery/releases
-  changelog_uri: https://gitlab.com/groups/gitlab-org/delivery/releases/CHANGELOG.md
+  source_code_uri: https://gitlab.com/gitlab-org/delivery/releases
+  changelog_uri: https://gitlab.com/gitlab-org/delivery/releases/CHANGELOG.md
 post_install_message:
 rdoc_options: []
 require_paths: