gitlab_support_readiness 1.0.11 → 1.0.13

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7b80e496307fbfaa496e95ca2af86a765ec8264d08cd70c5dde730305c597d2e
-  data.tar.gz: 0c1b9bf16c261245a4c8d8928d581bfe08d7b8e5dde42cee7fc55129233b42c4
+  metadata.gz: 8ea6f1d80c924ce2c4c9f4cb929873f6244376d783f507b71f42c2abc39a4943
+  data.tar.gz: 1f1902a265ada7bac8aad9b3183f068fb80cf7e0f841e92b9ef408ccc7cdef30
 SHA512:
-  metadata.gz: 9d38234f4a29dc2965e3544eb4e8f75830992cde999619b655ea1941c63255e1debb8aacccc841d92ecf6580a8ea2faf2d2c7edfbb9064df40fa5cd88c333977
-  data.tar.gz: 7419e41c9dbbe22058e0e567dc79b26c5408b3d4766e9d618dc3dfbd494f6b6619cf1d6a312c14dbd2df852c230098b75cbb76161c0f03b586638505e20a107d
+  metadata.gz: 6d8e2f831f94c90507f758dd744c4e8e84f4a7eb0041a763059b7a212d8a2e5a892a5f62ff692312a710c17b018ddc811be533dbdfb1c9a147779210e9327aac
+  data.tar.gz: 893eab1474c5eecdfcf18aa18cf6c6426e05e43e0ed8781f6dcf9107fecbc301277547f7b4aafe2f00bb02fa673135f72e0df0cdcd0df4c6ff03337236ab626d

data/lib/support_readiness/calendly/client.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+# Defines the module Readiness.
+module Readiness
+  # Defines the module Calendly
+  module Calendly
+    ##
+    # Defines the class Client within the module {Readiness::Calendly}.
+    #
+    # @author Jason Colyer
+    # @since 1.0.12
+    class Client
+      attr_reader :connection
+
+      ##
+      # Creates a new {Readiness::Calendly::Client} instance
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      # @param config [Object] An instance of {Readiness::Calendly::Configuration}
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::GitLab::Configuration.new
+      #   config.token = 'test123abc'
+      #   client = Readiness::GitLab::Client.new(config)
+      def initialize(config = Readiness::Calendly::Configuration.new)
+        @connection = generate_connection(config)
+      end
+
+      ##
+      # Used to generate the retry options passed to Faraday via faraday-retry
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      # @param config [Object] An instance of {Readiness::Calendly::Configuration}
+      # @return [Hash]
+      def retry_options(config)
+        {
+          max: config.retry_max,
+          interval: config.retry_interval,
+          interval_randomness: config.retry_randomness,
+          backoff_factor: config.retry_backoff,
+          exceptions: config.retry_exceptions
+        }
+      end
+
+      ##
+      # Used to generate a Faraday connection
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param config [Object] An instance of {Readiness::Calendly::Configuration}
+      # @return [Object]
+      def generate_connection(config)
+        Faraday.new(config.url) do |c|
+          c.request :retry, retry_options(config)
+          c.adapter Faraday.default_adapter
+          c.headers['Content-Type'] = 'application/json'
+          c.headers['Authorization'] = "Bearer #{config.token}"
+        end
+      end
+    end
+  end
+end

data/lib/support_readiness/calendly/configuration.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+# Defines the module Readiness.
+module Readiness
+  # Defines the module Calendly
+  module Calendly
+    ##
+    # Defines the class Configuration within the module {Readiness::Calendly}.
+    #
+    # @author Jason Colyer
+    # @since 1.0.12
+    class Configuration
+      attr_accessor :url, :token, :retry_options, :retry_max, :retry_interval, :retry_randomness, :retry_backoff, :retry_exceptions
+
+      ##
+      # Creates a new {Readiness::Calendly::Configuration} instance
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::Calendly::Configuration.new
+      #   config.token = 'test123abc'
+      #   pp config
+      #   # => #<Readiness::Calendly::Configuration:0x00007f352fdd1420
+      #          @retry_backoff=2,
+      #          @retry_exceptions=
+      #           [Errno::ETIMEDOUT, "Timeout::Error", Faraday::TimeoutError, Faraday::RetriableResponse, Faraday::ConnectionFailed],
+      #          @retry_interval=1,
+      #          @retry_max=5,
+      #          @retry_randomness=0.5,
+      #          @token="test123abc",
+      #          @url="https://api.calendly.com">
+      def initialize
+        @url = 'https://api.calendly.com'
+        @token = ''
+        @retry_max = 5
+        @retry_interval = 1
+        @retry_randomness = 0.5
+        @retry_backoff  = 2
+        @retry_exceptions = Faraday::Retry::Middleware::DEFAULT_EXCEPTIONS + [Faraday::ConnectionFailed]
+      end
+    end
+  end
+end

data/lib/support_readiness/calendly/organization_memberships.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+# Defines the module Readiness.
+module Readiness
+  # Defines the module Calendly
+  module Calendly
+    ##
+    # Defines the class OrganizationMemberships within the module {Readiness::Calendly}.
+    #
+    # @author Jason Colyer
+    # @since 1.0.12
+    class OrganizationMemberships < Readiness::Client
+      attr_accessor :created_at, :organization, :role, :updated_at, :uri, :user
+
+      ##
+      # Creates a new {Readiness::Calendly::OrganizationMemberships} instance
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      # @param object [Object] An instance of {Readiness::Calendly::OrganizationMemberships}
+      # @example
+      #   require 'support_readiness'
+      #   Readiness::Calendly::OrganizationMemberships.new
+      def initialize(object = {})
+        @created_at = object['created_at']
+        @organization = object['organization']
+        @role = object['role']
+        @updated_at = object['updated_at']
+        @uri = object['uri']
+        @user = (object['user'].nil? ? Users.new : Users.new(object['user']))
+      end
+
+      ##
+      # Provides a list of organization memberships.
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      # @param client [Object] An instance of {Readiness::Calendly::Client}
+      # @param organization [String] An instance of {Readiness::Calendly::Organizations}
+      # @return [Array]
+      # @see https://developer.calendly.com/api-docs/eaed2e61a6bc3-list-organization-memberships Calendly API > Organizations > List Organization Memberships
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::Calendly::Configuration.new
+      #   config.token = 'test123abc'
+      #   client = Readiness::Calendly::Client.new(config)
+      #   org = Readiness::Calendly::Organizations.find!(client, 'abc123')
+      #   members = Readiness::Calendly::Organizations.members(client, org)
+      #   pp members.first.name
+      #   # => "Jason Colyer"
+      def self.list(client, organization)
+        members = []
+        opts = { organization: organization.uri, count: 100 }
+        loop do
+          response = client.connection.get "organization_memberships", opts
+          handle_request_error(0, 'Calendly', response.status,  { action: 'get', id: organization.uri.split('/').last }) unless response.status == 200
+          body = Oj.load(response.body)
+          members += body['collection'].map { |c| OrganizationMemberships.new(c) }
+          break if body['pagination']['next_page_token'].nil?
+
+          opts = { organization: organization.uri, count: 100, page_token: body['pagination']['next_page_token'] }
+        end
+        members
+      end
+    end
+  end
+end

data/lib/support_readiness/calendly/organizations.rb

@@ -0,0 +1,123 @@
+# frozen_string_literal: true
+
+# Defines the module Readiness.
+module Readiness
+  # Defines the module Calendly
+  module Calendly
+    ##
+    # Defines the class Organizations within the module {Readiness::Calendly}.
+    #
+    # @author Jason Colyer
+    # @since 1.0.12
+    class Organizations < Readiness::Client
+      attr_accessor :created_at, :name, :plan, :stage, :updated_at, :uri
+
+      ##
+      # Creates a new {Readiness::Calendly::Organizations} instance
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      # @param object [Object] An instance of {Readiness::Calendly::Organizations}
+      # @example
+      #   require 'support_readiness'
+      #   Readiness::Calendly::Organizations.new
+      def initialize(object = {})
+        @created_at = object['created_at']
+        @name = object['name']
+        @plan = object['plan']
+        @stage = object['stage']
+        @updated_at = object['updated_at']
+        @uri = object['uri']
+      end
+
+      ##
+      # Returns the current user's organization within Calendly.
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      # @param client [Object] An instance of {Readiness::Calendly::Client}
+      # @return [Object] An instance of {Readiness::Calendly::Organizations}
+      # @see https://developer.calendly.com/api-docs/848e5e20591ee-organization Calendly API > Organizations > Organization
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::Calendly::Configuration.new
+      #   config.token = 'test123abc'
+      #   client = Readiness::Calendly::Client.new(config)
+      #   org = Readiness::Calendly::Organizations.current(client)
+      #   pp org.name
+      #   # => "GitLab Support"
+      def self.current(client)
+        user = Users.current(client)
+        Organizations.find(client, user.current_organization.split('/').last)
+      end
+
+      ##
+      # Locates an organization within Calendly. This will not exit on error (except Authentication errors)
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      # @param client [Object] An instance of {Readiness::Calendly::Client}
+      # @param oid [String] The organization ID to find
+      # @return [Object] An instance of {Readiness::Calendly::Organizations}
+      # @see https://developer.calendly.com/api-docs/848e5e20591ee-organization Calendly API > Organizations > Organization
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::Calendly::Configuration.new
+      #   config.token = 'test123abc'
+      #   client = Readiness::Calendly::Client.new(config)
+      #   org = Readiness::Calendly::Organizations.find(client, 'abc123')
+      #   pp org.name
+      #   # => "GitLab Support"
+      def self.find(client, oid)
+        response = client.connection.get "organizations/#{oid}"
+        handle_request_error(0, 'Calendly', response.status,  { action: 'get', id: oid }) unless response.status == 200
+        Organizations.new(Oj.load(response.body)['resource'])
+      end
+
+      ##
+      # Locates an organization within Calendly. This will exit on error
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      # @param client [Object] An instance of {Readiness::Calendly::Client}
+      # @param oid [String] The organization ID to find
+      # @return [Object] An instance of {Readiness::Calendly::Organizations}
+      # @see https://developer.calendly.com/api-docs/848e5e20591ee-organization Calendly API > Organizations > Organization
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::Calendly::Configuration.new
+      #   config.token = 'test123abc'
+      #   client = Readiness::Calendly::Client.new(config)
+      #   org = Readiness::Calendly::Organizations.find!(client, 'abc123')
+      #   pp org.name
+      #   # => "GitLab Support"
+      def self.find!(client, oid)
+        response = client.connection.get "organizations/#{oid}"
+        handle_request_error(1, 'Calendly', response.status, { action: 'Find organization', id: oid }) unless response.status == 200
+        Organizations.new(Oj.load(response.body)['resource'])
+      end
+
+      ##
+      # Provides a list of organization memberships. A wrapper for {OrganizationMemberships#list}
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      # @param client [Object] An instance of {Readiness::Calendly::Client}
+      # @param organization [String] An instance of {Readiness::Calendly::Organizations}
+      # @return [Array]
+      # @see https://developer.calendly.com/api-docs/eaed2e61a6bc3-list-organization-memberships Calendly API > Organizations > List Organization Memberships
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::Calendly::Configuration.new
+      #   config.token = 'test123abc'
+      #   client = Readiness::Calendly::Client.new(config)
+      #   org = Readiness::Calendly::Organizations.find!(client, 'abc123')
+      #   members = Readiness::Calendly::Organizations.members(client, org)
+      #   pp members.first.name
+      #   # => "Jason Colyer"
+      def self.members(client, organization)
+        Readiness::Calendly::OrganizationMemberships.list(client, organization)
+      end
+    end
+  end
+end

data/lib/support_readiness/calendly/users.rb

@@ -0,0 +1,105 @@
+# frozen_string_literal: true
+
+# Defines the module Readiness.
+module Readiness
+  # Defines the module Calendly
+  module Calendly
+    ##
+    # Defines the class Users within the module {Readiness::Calendly}.
+    #
+    # @author Jason Colyer
+    # @since 1.0.12
+    class Users < Readiness::Client
+      attr_accessor :avatar_url, :created_at, :current_organization, :email, :name, :resource_type, :scheduling_url, :slug, :timezone, :updated_at, :uri
+
+      ##
+      # Creates a new {Readiness::Calendly::Users} instance
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      # @param object [Object] An instance of {Readiness::Calendly::Users}
+      # @example
+      #   require 'support_readiness'
+      #   Readiness::Calendly::Users.new
+      def initialize(object = {})
+        @avatar_url = object['avatar_url']
+        @created_at = object['created_at']
+        @current_organization = object['current_organization']
+        @email = object['email']
+        @name = object['name']
+        @resource_type = object['resource_type']
+        @scheduling_url = object['scheduling_url']
+        @slug = object['slug']
+        @timezone = object['timezone']
+        @updated_at = object['updated_at']
+        @uri = object['uri']
+      end
+
+      ##
+      # Gets information on the current user
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      # @param client [Object] An instance of {Readiness::Calendly::Client}
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::Calendly::Configuration.new
+      #   config.token = 'abc123'
+      #   client = Readiness::Calendly::Client.new(config)
+      #   user = Readiness::Calendly::Users.current(client)
+      #   pp user.name
+      #   # => "John Doe"
+      def self.current(client)
+        response = client.connection.get 'users/me'
+        handle_request_error(0, 'Calendly', response.status) unless response.status == 200
+        Users.new(Oj.load(response.body)['resource'])
+      end
+
+      ##
+      # Locates an user within Calendly. This will not exit on error (except Authentication errors)
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      # @param client [Object] An instance of {Readiness::Calendly::Client}
+      # @param uid [String] The user ID to find
+      # @return [Object] An instance of {Readiness::Calendly::Users}
+      # @see https://developer.calendly.com/api-docs/ff9832c5a6640-get-user Calendly API > Users > Get user
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::Calendly::Configuration.new
+      #   config.token = 'test123abc'
+      #   client = Readiness::Calendly::Client.new(config)
+      #   user = Readiness::Calendly::Users.find(client, 'abc123')
+      #   pp user.name
+      #   # => "Jason Colyer"
+      def self.find(client, uid)
+        response = client.connection.get "users/#{uid}"
+        handle_request_error(0, 'Calendly', response.status,  { action: 'get', id: uid }) unless response.status == 200
+        Users.new(Oj.load(response.body)['resource'])
+      end
+
+      ##
+      # Locates an user within Calendly.  This will exit on error
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      # @param client [Object] An instance of {Readiness::Calendly::Client}
+      # @param uid [String] The user ID to find
+      # @return [Object] An instance of {Readiness::Calendly::Users}
+      # @see https://developer.calendly.com/api-docs/ff9832c5a6640-get-user Calendly API > Users > Get user
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::Calendly::Configuration.new
+      #   config.token = 'test123abc'
+      #   client = Readiness::Calendly::Client.new(config)
+      #   user = Readiness::Calendly::Users.find!(client, 'abc123')
+      #   pp user.name
+      #   # => "Jason Colyer"
+      def self.find!(client, uid)
+        response = client.connection.get "users/#{uid}"
+        handle_request_error(1, 'Calendly', response.status, { action: 'Find user', id: uid }) unless response.status == 200
+        Users.new(Oj.load(response.body)['resource'])
+      end
+    end
+  end
+end

data/lib/support_readiness/calendly.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+# Defines the module Readiness.
+module Readiness
+  ##
+  # Defines the module Calendly
+  # @author Jason Colyer
+  # @since 1.0.12
+  module Calendly
+    require "#{__dir__}/calendly/client"
+    require "#{__dir__}/calendly/configuration"
+    require "#{__dir__}/calendly/users"
+    require "#{__dir__}/calendly/organization_memberships"
+    require "#{__dir__}/calendly/organizations"
+  end
+end

data/lib/support_readiness/client.rb

@@ -127,7 +127,7 @@ module Readiness
     # @param system [String] The system the error occurred on
     # @param params [Hash] A Hash of information about the request
     def self.bad_request_error(system, params)
-      puts "Action '#{params[:action]}' to ID #{params[:id]} on #{system} returned a 404 error"
+      puts "Action '#{params[:action]}' to ID #{params[:id]} on #{system} returned a 400 error"
       exit 1
     end
 
@@ -143,5 +143,92 @@ module Readiness
       pp params[:message]
       exit 1
     end
+
+    ##
+    # Generates a Time String to be used in zip file generation
+    #
+    # @author Jason Colyer
+    # @since 1.0.12
+    def self.timestamp_filename
+      @name ||= Time.now.strftime('%Y%m%d%H%M%S%L')
+    end
+
+    ##
+    # Generates a Time String to be used in zip file generation
+    #
+    # @author Jason Colyer
+    # @since 1.0.12
+    # @param item_list [Array] An Array of items to zip
+    # @return [String] The path to the zip file
+    def self.create_package!(item_list, input_dir = './')
+      @output_file = "data/#{timestamp_filename}.zip"
+      @input_dir = input_dir
+      Zip::File.open(@output_file, create: true) do |zipfile|
+        write_entries item_list, '', zipfile
+      end
+      @output_file
+    end
+
+    ##
+    # Writes entries to a zip file
+    #
+    # @author Jason Colyer
+    # @since 1.0.12
+    # @param items [Array] An Array of items to zip
+    # @param path [String] The path to the items
+    # @param zipfile [Object] The Zip object
+    def self.write_entries(items, path, zipfile)
+      items.each do |i|
+        zipfile_path = path == '' ? i : File.join(path, i)
+        disk_file_path = File.join(@input_dir, zipfile_path)
+        if File.directory? disk_file_path
+          recursively_deflate_directory(disk_file_path, zipfile, zipfile_path)
+        else
+          put_into_archive(disk_file_path, zipfile, zipfile_path)
+        end
+      end
+    end
+
+    ##
+    # Recusrively zips a folder
+    #
+    # @author Jason Colyer
+    # @since 1.0.12
+    # @param disk_file_path [String] The path to the folder
+    # @param zipfile [Object] The Zip object
+    # @param zipfile_path [String] The path to the folder within the zip file
+    def self.recursively_deflate_directory(disk_file_path, zipfile, zipfile_path)
+      zipfile.mkdir zipfile_path
+      subdir = Dir.entries(disk_file_path) - %w[. ..]
+      write_entries subdir, zipfile_path, zipfile
+    end
+
+    ##
+    # Adds an item to the zip file
+    #
+    # @author Jason Colyer
+    # @since 1.0.12
+    # @param disk_file_path [String] The path to the folder
+    # @param zipfile [Object] The Zip object
+    # @param zipfile_path [String] The path to the folder within the zip file
+    def self.put_into_archive(disk_file_path, zipfile, zipfile_path)
+      zipfile.add(zipfile_path, disk_file_path)
+    end
+
+    ##
+    # Generate an ERB renderer for a specific file
+    #
+    # @author Jason Colyer
+    # @since 1.0.12
+    # @param file [String] The path (relative or absolute) to the file to render
+    # @example
+    #   require 'support_readiness'
+    #   renderer = Readiness::Client.erb_renderer('temp.erb')
+    #   body = renderer.result_with_hash(name: 'Jason')
+    #   pp body
+    #   # => "\n" + "Hello Jason!\n"
+    def self.erb_renderer(file)
+      ERB.new(File.read(file))
+    end
   end
 end

data/lib/support_readiness/dates.rb

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+# Defines the module Readiness.
+module Readiness
+  ##
+  # Defines the class Dates within the module {Readiness}.
+  #
+  # @author Jason Colyer
+  # @since 1.0.12
+  class Dates
+    ##
+    # Return the current GitLab quarter as of the current date in format "FY##Q#"
+    #
+    # @return [String]
+    # @example
+    #   require 'support_readiness'
+    #   pp Readiness::Dates.current_quarter
+    #   # => "FY25Q3"
+    def self.current_quarter
+      determine_quarter(Time.now)
+    end
+
+    ##
+    # Return the next GitLab quarter in format "FY##Q#". Defaults to assuming you mean for the current date
+    #
+    # @param date [Various] The date to reference. Can take a String, Date, DateTime, or Time object
+    # @return [String]
+    # @example
+    #   require 'support_readiness'
+    #   pp Readiness::Dates.next_quarter
+    #   # => "FY25Q4"
+    def self.next_quarter(date = Time.now)
+      current = determine_quarter(date)
+      year = current.split('Q').first.split('FY').last.to_i
+      quarter = current.split('Q').last.to_i
+      if quarter == 4
+        "FY#{year + 1}Q1"
+      else
+        "FY#{year}Q#{quarter + 1}"
+      end
+    end
+
+    ##
+    # Return the previous GitLab quarter in format "FY##Q#". Defaults to assuming you mean for the current date
+    #
+    # @param date [Various] The date to reference. Can take a String, Date, DateTime, or Time object
+    # @return [String]
+    # @example
+    #   require 'support_readiness'
+    #   pp Readiness::Dates.next_quarter
+    #   # => "FY25Q4"
+    def self.previous_quarter(date = Time.now)
+      current = determine_quarter(date)
+      year = current.split('Q').first.split('FY').last.to_i
+      quarter = current.split('Q').last.to_i
+      if quarter == 1
+        "FY#{year - 1}Q4"
+      else
+        "FY#{year}Q#{quarter - 1}"
+      end
+    end
+
+    ##
+    # Returns the GitLab quarter in format "FY##Q#" from a give date
+    #
+    # @param date [Various] The date to reference. Can take a String, Date, DateTime, or Time object
+    # @return [String]
+    # @example
+    #   require 'support_readiness'
+    #   pp Readiness::Dates.next_quarter
+    #   # => "FY25Q4"
+    def self.determine_quarter(date)
+      date = Time.parse(date) unless [DateTime, Date, Time].include? date.class
+      month = date.month
+      year = date.year.digits(100).first
+      case month
+      when 1
+        "FY#{year}Q4"
+      when 2..4
+        "FY#{year + 1}Q1"
+      when 5..7
+        "FY#{year + 1}Q2"
+      when 8..10
+        "FY#{year + 1}Q3"
+      when 11..12
+        "FY#{year + 1}Q4"
+      end
+    end
+  end
+end

data/lib/support_readiness/gitlab/configuration.rb

@@ -31,7 +31,6 @@ module Readiness
       #          @retry_randomness=0.5,
       #          @token="test123abc",
       #          @url="https://gitlab.com/api/v4">
-
       def initialize
         @url = 'https://gitlab.com/api/v4'
         @token = ''

data/lib/support_readiness/gitlab/groups.rb

@@ -175,6 +175,41 @@ module Readiness
         end
         array
       end
+
+      ##
+      # Lists all milestones in a group.
+      # This method can take a long time to run depending on the parameters used.
+      #
+      # @author Jason Colyer
+      # @since 1.0.12
+      # @param client [Object] An instance of {Readiness::GitLab::Client}
+      # @param group [Object] An instance of {Readiness::GitLab::Groups}
+      # @param filters [Array] An array of filter Strings to use. Should be in the format of key=value
+      # @return [Array]
+      # @see https://docs.gitlab.com/ee/api/group_milestones.html#list-group-milestones GitLab API > Groups > Milestones > List group milestones
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::GitLab::Configuration.new
+      #   config.token = 'test123abc'
+      #   client = Readiness::GitLab::Client.new(config)
+      #   group = Readiness::GitLab::Groups.find!(client, 1083469)
+      #   milestones = Readiness::GitLab::Groups.milestones(client, project)
+      #   pp milestones.count
+      #   # => 25
+      def self.milestones(client, group, filters = [])
+        array = []
+        page = 0
+        loop do
+          response = client.connection.get "groups/#{group.id}/milestones?per_page=100&page=#{page}&#{to_param_string(filters)}"
+          handle_request_error(0, 'GitLab', response.status) unless response.status == 200
+          body = Oj.load(response.body)
+          array += body
+          break if body.count < 100
+
+          page += 1
+        end
+        array
+      end
     end
   end
 end