gitlab_support_readiness 1.0.0

data/lib/support_readiness/gitlab/issues.rb

@@ -0,0 +1,410 @@
+# frozen_string_literal: true
+
+# Defines the module Readiness.
+module Readiness
+  # Defines the module GitLab
+  module GitLab
+    ##
+    # Defines the class Issues within the module {Readiness::GitLab}.
+    #
+    # @author Jason Colyer
+    # @since 1.0.0
+    # @todo Anything listed on https://docs.gitlab.com/ee/api/issues.html not currently here
+    class Issues < Readiness::Client
+      attr_accessor :assignee_id, :assignee_ids, :assignees, :author, :blocking_issues_count, :closed_at, :closed_by, :confidential, :created_at, :description, :discussion_locked, :downvotes, :due_date, :epic, :has_tasks, :health_status, :id, :iid, :imported, :imported_from, :issue_type, :iteration, :labels, :_links, :merge_requests_count, :milestone, :moved_to_id, :project_id, :references, :service_desk_reply_to, :severity, :state, :state_event, :task_completion_status, :task_status, :time_stats, :title, :type, :updated_at, :upvotes, :user_notes_count, :web_url, :weight
+
+      ##
+      # Creates a new {Readiness::GitLab::Issues} instance
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param object [Object] An instance of {Readiness::GitLab::Issues}
+      # @example
+      #   require 'support_readiness'
+      #   Readiness::GitLab::Issues.new
+      def initialize(object = {})
+        @assignee_id = object['assignee_id']
+        @assignee_ids = object['assignee_ids']
+        @assignees = object['assignees']
+        @author = object['author']
+        @blocking_issues_count = object['blocking_issues_count']
+        @closed_at = object['closed_at']
+        @closed_by = object['closed_by']
+        @confidential = object['confidential']
+        @created_at = object['created_at']
+        @description = object['description']
+        @discussion_locked = object['discussion_locked']
+        @downvotes = object['downvotes']
+        @due_date = object['due_date']
+        @epic = object['epic']
+        @has_tasks = object['has_tasks']
+        @health_status = object['health_status']
+        @id = object['id']
+        @iid = object['iid']
+        @imported = object['imported']
+        @imported_from = object['imported_from']
+        @issue_type = object['issue_type']
+        @iteration = object['iteration']
+        @labels = object['labels']
+        @_links = object['_links']
+        @merge_requests_count = object['merge_requests_count']
+        @milestone = object['milestone']
+        @moved_to_id = object['moved_to_id']
+        @project_id = object['project_id']
+        @references = object['references']
+        @service_desk_reply_to = object['service_desk_reply_to']
+        @severity = object['severity']
+        @state = object['state']
+        @state_event = object['state_event']
+        @task_completion_status = object['task_completion_status']
+        @task_status = object['task_status']
+        @time_stats = object['time_stats']
+        @title = object['title']
+        @type = object['type']
+        @updated_at = object['updated_at']
+        @upvotes = object['upvotes']
+        @user_notes_count = object['user_notes_count']
+        @web_url = object['web_url']
+        @weight = object['weight']
+      end
+
+      ##
+      # Lists all issues. Does not stop until it ends or the page limit is hit.
+      # This method can take a long time to run depending on the parameters used.
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param client [Object] An instance of {Readiness::GitLab::Client}
+      # @param limit [Integer] The number of pages to stop at. Using 0 means to list all.
+      # @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/issues.html#list-issues GitLab API > Issues > List issues
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::GitLab::Configuration.new
+      #   config.token = 'test123abc'
+      #   client = Readiness::GitLab::Client.new(config)
+      #   issues = Readiness::GitLab::Issues.list_all(client, 2, ["assignee_id=5", "state=opened"])
+      #   puts issues.first.web_url
+      #   # => "https://gitlab.com/gitlab-com/support/support-team-meta/-/issues/1"
+      def self.list_all(client, limit = 0, filters = [])
+        array = []
+        page = 1
+        loop do
+          response = client.connection.get "issues?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.map { |p| Issues.new(p) }
+          break if body.count < 100
+          break if limit != 0 && array.count >= (limit * 100)
+
+          page += 1
+        end
+        array
+      end
+
+      ##
+      # Lists all issues for an object. Does not stop until it ends or the page limit is hit.
+      # This method can take a long time to run depending on the parameters used.
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param client [Object] An instance of {Readiness::GitLab::Client}
+      # @param object [Object] An instance of {Readiness::GitLab::Projects} or {Readiness::GitLab::Groups}
+      # @param limit [Integer] The number of pages to stop at. Using 0 means to list all.
+      # @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/issues.html#list-issues GitLab API > Issues > List issues
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::GitLab::Configuration.new
+      #   config.token = 'test123abc'
+      #   client = Readiness::GitLab::Client.new(config)
+      #   project = Readiness::GitLab::Projects.find!(client, 1083469)
+      #   issues = Readiness::GitLab::Issues.list(client, project, 2, ["assignee_id=5", "state=opened"])
+      #   puts issues.first.web_url
+      #   # => "https://gitlab.com/gitlab-com/support/support-team-meta/-/issues/2"
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::GitLab::Configuration.new
+      #   config.token = 'test123abc'
+      #   client = Readiness::GitLab::Client.new(config)
+      #   group = Readiness::GitLab::Groups.find!(client, 2573511)
+      #   issues = Readiness::GitLab::Issues.list(client, group, 2, ["assignee_id=5", "state=opened"])
+      #   puts issues.first.web_url
+      #   # => "https://gitlab.com/gitlab-com/support/support-team-meta/-/issues/3"
+      def self.list(client, object, limit = 0, filters = [])
+        array = []
+        page = 1
+        loop do
+          response = client.connection.get "#{object.class.name.split('::').last.downcase}/#{object.id}/issues?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.map { |p| Issues.new(p) }
+          break if body.count < 100
+          break if limit != 0 && array.count >= (limit * 100)
+
+          page += 1
+        end
+        array
+      end
+
+      ##
+      # Locates a project issue within GitLab. This will not exit on error (except Authentication errors)
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param client [Object] An instance of {Readiness::GitLab::Client}
+      # @param project [Object] An instance of {Readiness::GitLab::Projects}
+      # @param iid [Integer] The issue ID to find
+      # @return [Hash]
+      # @see https://docs.gitlab.com/ee/api/issues.html#single-project-issue GitLab API > Issues > Single project issue
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::GitLab::Configuration.new
+      #   config.token = 'test123abc'
+      #   client = Readiness::GitLab::Client.new(config)
+      #   project = Readiness::GitLab::Projects.find!(client, 1083469)
+      #   issue = Readiness::GitLab::Issues.find(client, project, 5)
+      #   puts issues.web_url
+      #   # => "https://gitlab.com/gitlab-com/support/support-team-meta/-/issues/5"
+      def self.find(client, project, iid)
+        response = client.connection.get "projects/#{project.id}/issues/#{iid}"
+        handle_request_error(0, 'GitLab', response.status,  { action: 'get', id: iid }) unless response.status == 200
+        return Issues.new(Oj.load(response.body)) if response.status == 200
+
+        Oj.load(response.body)
+      end
+
+      ##
+      # Locates a project issue within GitLab. This will exit on error
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param client [Object] An instance of {Readiness::GitLab::Client}
+      # @param project [Object] An instance of {Readiness::GitLab::Projects}
+      # @param iid [Integer] The issue ID to find
+      # @return [Object] An instance of {Readiness::GitLab::Issues}
+      # @see https://docs.gitlab.com/ee/api/issues.html#single-project-issue GitLab API > Issues > Single project issue
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::GitLab::Configuration.new
+      #   config.token = 'test123abc'
+      #   client = Readiness::GitLab::Client.new(config)
+      #   project = Readiness::GitLab::Projects.find!(client, 1083469)
+      #   issue = Readiness::GitLab::Issues.find!(client, project, 5)
+      #   puts issues.web_url
+      #   # => "https://gitlab.com/gitlab-com/support/support-team-meta/-/issues/5"
+      def self.find!(client, project, iid)
+        response = client.connection.get "projects/#{project.id}/issues/#{iid}"
+        handle_request_error(1, 'GitLab', response.status, { action: 'Find issue', id: iid }) unless response.status == 200
+        Issues.new(Oj.load(response.body))
+      end
+
+      ##
+      # Creates a project issue within GitLab. This will exit on error
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param client [Object] An instance of {Readiness::GitLab::Client}
+      # @param project [Object] An instance of {Readiness::GitLab::Projects}
+      # @param issue [Object] An instance of {Readiness::GitLab::Issues}
+      # @return [Object] An instance of {Readiness::GitLab::Issues}
+      # @see https://docs.gitlab.com/ee/api/issues.html#new-issue GitLab API > Issues > New issue
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::GitLab::Configuration.new
+      #   config.token = 'test123abc'
+      #   client = Readiness::GitLab::Client.new(config)
+      #   project = Readiness::GitLab::Projects.find!(client, 1083469)
+      #   issue = Readiness::GitLab::Issues.new
+      #   issue.title = 'Important issue!'
+      #   issue.description = 'This is totally important!'
+      #   issue.assignee_ids = [1, 3, 4]
+      #   new_issue = Readiness::GitLab::Issues.create!(client, project, issue)
+      #   puts new_issue.web_url
+      #   # => "https://gitlab.com/gitlab-com/support/support-team-meta/-/issues/8"
+      def self.create!(client, project, issue)
+        response = client.connection.post "projects/#{project.id}/issues", to_clean_json(issue)
+        handle_request_error(1, 'GitLab', response.status, { action: 'Create issue', id: project.id }) unless response.status == 200
+        Issues.new(Oj.load(response.body))
+      end
+
+      ##
+      # Updates a project issue within GitLab. This will exit on error
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param client [Object] An instance of {Readiness::GitLab::Client}
+      # @param project [Object] An instance of {Readiness::GitLab::Projects}
+      # @param issue [Object] An instance of {Readiness::GitLab::Issues}
+      # @return [Object] An instance of {Readiness::GitLab::Issues}
+      # @see https://docs.gitlab.com/ee/api/issues.html#edit-an-issue GitLab API > Issues > Edit an issue
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::GitLab::Configuration.new
+      #   config.token = 'test123abc'
+      #   client = Readiness::GitLab::Client.new(config)
+      #   project = Readiness::GitLab::Projects.find!(client, 1083469)
+      #   issue = Readiness::GitLab::Issues.find!(client, project, 8)
+      #   issue.title = 'Important issue v2!'
+      #   new_issue = Readiness::GitLab::Issues.update!(client, project, issue)
+      #   puts new_issue.title
+      #   # => "Important issue v2!"
+      def self.update!(client, project, issue)
+        response = client.connection.put "projects/#{project.id}/issues/#{issue.iid}", to_clean_json(issue)
+        handle_request_error(1, 'GitLab', response.status, { action: 'Update an issue', id: "#{project.id}/issues/#{issue.iid}" }) unless response.status == 200
+        Issues.new(Oj.load(response.body))
+      end
+
+      ##
+      # Deletes a project issue within GitLab. This will exit on error
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param client [Object] An instance of {Readiness::GitLab::Client}
+      # @param project [Object] An instance of {Readiness::GitLab::Projects}
+      # @param issue [Object] An instance of {Readiness::GitLab::Issues}
+      # @return [Boolean]
+      # @see https://docs.gitlab.com/ee/api/issues.html#delete-an-issue GitLab API > Issues > Delete an issue
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::GitLab::Configuration.new
+      #   config.token = 'test123abc'
+      #   client = Readiness::GitLab::Client.new(config)
+      #   project = Readiness::GitLab::Projects.find!(client, 1083469)
+      #   issue = Readiness::GitLab::Issues.find!(client, project, 8)
+      #   pp Readiness::GitLab::Issues.delete!(client, project, issue)
+      #    # => true
+      def self.delete!(client, project, issue)
+        response = client.connection.delete "projects/#{project.id}/issues/#{issue.iid}"
+        handle_request_error(1, 'GitLab', response.status, { action: 'Delete an issue', id: "#{project.id}/issues/#{issue.iid}" }) unless response.status == 204
+        true
+      end
+
+      ##
+      # Get all comments on a project issue within GitLab.
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param client [Object] An instance of {Readiness::GitLab::Client}
+      # @param project [Object] An instance of {Readiness::GitLab::Projects}
+      # @param issue [Object] An instance of {Readiness::GitLab::Issues}
+      # @return [Array]
+      # @see https://docs.gitlab.com/ee/api/notes.html#list-project-issue-notese GitLab API > Notes (comments) > List project issue notes
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::GitLab::Configuration.new
+      #   config.token = 'test123abc'
+      #   client = Readiness::GitLab::Client.new(config)
+      #   project = Readiness::GitLab::Projects.find!(client, 5)
+      #   issue = Readiness::GitLab::Issues.find!(client, project, 11)
+      #   comments = Readiness::GitLab::Issues.comments(client, project, issue)
+      #   pp comments.first['updated_at']
+      #    # => "2013-10-02T09:56:03Z"
+      def self.comments(client, project, issue)
+        array = []
+        page = 0
+        loop do
+          response = client.connection.get "projects/#{project.id}/issues/#{issues.id}/notes?per_page=100&page=#{page}"
+          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
+
+      ##
+      # Create a comment on a project issue within GitLab.
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param client [Object] An instance of {Readiness::GitLab::Client}
+      # @param project [Object] An instance of {Readiness::GitLab::Projects}
+      # @param issue [Object] An instance of {Readiness::GitLab::Issues}
+      # @param params [Hash] The parameters to use in creating the comment
+      # @return [Hash]
+      # @see https://docs.gitlab.com/ee/api/notes.html#create-new-issue-note GitLab API > Notes (comments) > Create new issue note
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::GitLab::Configuration.new
+      #   config.token = 'test123abc'
+      #   client = Readiness::GitLab::Client.new(config)
+      #   project = Readiness::GitLab::Projects.find!(client, 5)
+      #   issue = Readiness::GitLab::Issues.find!(client, project, 11)
+      #   comment_params = {
+      #     body: 'My name is Jason and I approve this comment',
+      #     internal: true
+      #   }
+      #   comment = Readiness::GitLab::Issues.create_comment(client, project, issue, comment_params)
+      #   pp comment['updated_at']
+      #    # => "2024-09-23T15:42:13Z"
+      def self.create_comment!(client, project, issue, params)
+        response = client.connection.post "projects/#{project.id}/issues/#{issue.id}/notes", to_clean_json(params)
+        handle_request_error(1, 'GitLab', response.status, { action: 'Create issue comment', id: issue.id }) unless response.status == 200
+        Oj.load(response.body)
+      end
+
+      ##
+      # Updates a comment on a project issue within GitLab.
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param client [Object] An instance of {Readiness::GitLab::Client}
+      # @param project [Object] An instance of {Readiness::GitLab::Projects}
+      # @param issue [Object] An instance of {Readiness::GitLab::Issues}
+      # @param cid [Integer] The comment ID to modify
+      # @param params [Hash] The parameters to use for the update
+      # @return [Hash]
+      # @see https://docs.gitlab.com/ee/api/notes.html#modify-existing-issue-note GitLab API > Notes (comments) > Modify an existing issue note
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::GitLab::Configuration.new
+      #   config.token = 'test123abc'
+      #   client = Readiness::GitLab::Client.new(config)
+      #   project = Readiness::GitLab::Projects.find!(client, 5)
+      #   issue = Readiness::GitLab::Issues.find!(client, project, 11)
+      #   comment_params = {
+      #     internal: false
+      #   }
+      #   comment = Readiness::GitLab::Issues.update_comment!(client, project, issue, 15, comment_params)
+      #   pp comment['updated_at']
+      #    # => "2024-09-23T16:47:36Z"
+      def self.update_comment!(client, project, issue, cid, params)
+        response = client.connection.put "projects/#{project.id}/issues/#{issue.id}/notes/#{cid}", to_clean_json(params)
+        handle_request_error(1, 'GitLab', response.status, { action: 'Update issue comment', id: issue.id }) unless response.status == 200
+        Oj.load(response.body)
+      end
+
+      ##
+      # Deletes a comment on a project issue within GitLab.
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param client [Object] An instance of {Readiness::GitLab::Client}
+      # @param project [Object] An instance of {Readiness::GitLab::Projects}
+      # @param issue [Object] An instance of {Readiness::GitLab::Issues}
+      # @param cid [Integer] The comment ID to modify
+      # @return [Boolean]
+      # @see https://docs.gitlab.com/ee/api/notes.html#delete-an-issue-note GitLab API > Notes (comments) > Delete an issue note
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::GitLab::Configuration.new
+      #   config.token = 'test123abc'
+      #   client = Readiness::GitLab::Client.new(config)
+      #   project = Readiness::GitLab::Projects.find!(client, 5)
+      #   issue = Readiness::GitLab::Issues.find!(client, project, 11)
+      #   comment = Readiness::GitLab::Issues.delete_comment!(client, project, issue, 15)
+      #   pp comment
+      #    # => true
+      def self.delete_comment!(client, project, issue, cid)
+        response = client.connection.delete "projects/#{project.id}/issues/#{issue.id}/notes/#{cid}"
+        handle_request_error(1, 'GitLab', response.status, { action: 'Delete issue comment', id: issue.id }) unless response.status == 204
+        true
+      end
+    end
+  end
+end

data/lib/support_readiness/gitlab/namespaces.rb

@@ -0,0 +1,190 @@
+# frozen_string_literal: true
+
+# Defines the module Readiness.
+module Readiness
+  # Defines the module GitLab
+  module GitLab
+    ##
+    # Defines the class Namespaces within the module {Readiness::GitLab}.
+    #
+    # @author Jason Colyer
+    # @since 1.0.0
+    class Namespaces < Readiness::Client
+      attr_accessor :avatar_url, :billable_members_count, :end_date, :full_path, :id, :kind, :max_seats_used, :members_count_with_descendants, :name, :parent_id, :path, :plan, :root_repository_size, :seats_in_use, :trial_ends_on, :trial, :web_url
+
+      ##
+      # Creates a new {Readiness::GitLab::Namespaces} instance
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param object [Object] An instance of {Readiness::GitLab::Namespaces}
+      # @example
+      #   require 'support_readiness'
+      #   Readiness::GitLab::Namespaces.new
+      def initialize(object = {})
+        @avatar_url = object['avatar_url']
+        @billable_members_count = object['billable_members_count']
+        @end_date = object['end_date']
+        @full_path = object['full_path']
+        @id = object['id']
+        @kind = object['kind']
+        @max_seats_used = object['max_seats_used']
+        @members_count_with_descendants = object['members_count_with_descendants']
+        @name = object['name']
+        @parent_id = object['parent_id']
+        @path = object['path']
+        @plan = object['plan']
+        @root_repository_size = object['root_repository_size']
+        @seats_in_use = object['seats_in_use']
+        @trial_ends_on = object['trial_ends_on']
+        @trial = object['trial']
+        @web_url = object['web_url']
+      end
+
+      ##
+      # Search for a namespace by name.
+      # This method can take a long time to run depending on the number of results found or permission level used.
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param client [Object] An instance of {Readiness::GitLab::Client}
+      # @param query [String] The name to search for
+      # @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/namespaces.html#list-namespaces GitLab API > Namespaces > List namespaces
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::GitLab::Configuration.new
+      #   config.token = 'test123abc'
+      #   client = Readiness::GitLab::Client.new(config)
+      #   namespaces = Readiness::GitLab::Namespaces.search(client, 'jason_rocks', ["owned_only=true"])
+      #   pp namespaces.first.full_path
+      #   # => "jason-group/jason-rocks"
+      def self.search(client, query, filters = [])
+        response = client.connection.get "namespaces?search=#{query}&#{to_param_string(filters)}"
+        handle_request_error(0, 'GitLab', response.status) unless response.status == 200
+        Oj.load(response.body).map { |n| Namespaces.new(n) }
+      end
+
+      ##
+      # Checks if a namespace exists
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param client [Object] An instance of {Readiness::GitLab::Client}
+      # @param name [String] The namespace to check for
+      # @return [Boolean]
+      # @see https://docs.gitlab.com/ee/api/namespaces.html#get-existence-of-a-namespace GitLab API > Namespaces > Get existence of a namespace
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::GitLab::Configuration.new
+      #   config.token = 'test123abc'
+      #   client = Readiness::GitLab::Client.new(config)
+      #   pp Readiness::GitLab::Namespaces.exists?(client, 'jason_rocks')
+      #   # => true
+      #   pp Readiness::GitLab::Namespaces.exists?(client, 'jason_does_not_rock')
+      #   # => false
+      def self.exists?(client, name)
+        response = client.connection.get "namespaces/#{name}/exists"
+        handle_request_error(0, 'GitLab', response.status) unless response.status == 200
+        Oj.load(response.body)['exists']
+      end
+
+      ##
+      # Locates a namespace within GitLab. This will not exit on error (except Authentication errors)
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param client [Object] An instance of {Readiness::GitLab::Client}
+      # @param nid [Integer] The namespace ID to find
+      # @return [Hash]
+      # @see https://docs.gitlab.com/ee/api/namespaces.html#get-namespace-by-id GitLab API > Namespaces > Get namespace by ID
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::GitLab::Configuration.new
+      #   config.token = 'test123abc'
+      #   client = Readiness::GitLab::Client.new(config)
+      #   namespace = Readiness::GitLab::Namespaces.find(client, 123)
+      #   pp namespace.web_url
+      #   # => "https://gitlab.com/groups/group123"
+      def self.find(client, nid)
+        response = client.connection.get "namespaces/#{nid}"
+        handle_request_error(0, 'GitLab', response.status,  { action: 'get', id: nid }) unless response.status == 200
+        return Namespaces.new(Oj.load(response.body)) if response.status == 200
+
+        Oj.load(response.body)
+      end
+
+      ##
+      # Locates a namespace within GitLab. This will exit on error
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param client [Object] An instance of {Readiness::GitLab::Client}
+      # @param nid [Integer] The namespace ID to find
+      # @return [Object] An instance of {Readiness::GitLab::Namespaces}
+      # @see https://docs.gitlab.com/ee/api/namespaces.html#get-namespace-by-id GitLab API > Namespaces > Get namespace by ID
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::GitLab::Configuration.new
+      #   config.token = 'test123abc'
+      #   client = Readiness::GitLab::Client.new(config)
+      #   namespace = Readiness::GitLab::Namespaces.find!(client, 123)
+      #   pp namespace.web_url
+      #   # => "https://gitlab.com/groups/group123"
+      def self.find!(client, nid)
+        response = client.connection.get "namespaces/#{nid}"
+        handle_request_error(1, 'GitLab', response.status, { action: 'Find namespace', id: nid }) unless response.status == 200
+        Namespaces.new(Oj.load(response.body))
+      end
+
+      ##
+      # Locates the group owners for a namespace within GitLab
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param client [Object] An instance of {Readiness::GitLab::Client}
+      # @param namespace [Object] An instance of {Readiness::GitLab::Namespaces}
+      # @return [Array]
+      # @see https://docs.gitlab.com/ee/development/internal_api/gitlab_subscriptions.html#fetch-group-owners GitLab API > Internal API > GitLab Subscriptions > Fetch group owners
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::GitLab::Configuration.new
+      #   config.token = 'test123abc'
+      #   client = Readiness::GitLab::Client.new(config)
+      #   namespace = Readiness::GitLab::Namespaces.find!(client, 123)
+      #   owners = Readiness::GitLab::Namespaces.owners(client, namespace)
+      #   pp owners.last['user']['name']
+      #   # => "John Smith"
+      def self.owners(client, namespace)
+        response = client.connection.get "internal/gitlab_subscriptions/namespaces/#{namespace.id}/owners"
+        handle_request_error(0, 'GitLab', response.status,  { action: 'get', id: namespace.id }) unless response.status == 200
+        Oj.load(response.body)
+      end
+
+      ##
+      # Locates the subscription for a namespace within GitLab
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param client [Object] An instance of {Readiness::GitLab::Client}
+      # @param namespace [Object] An instance of {Readiness::GitLab::Namespaces}
+      # @return [Array]
+      # @see https://docs.gitlab.com/ee/development/internal_api/gitlab_subscriptions.html#fetch-a-subscription GitLab API > Internal API > GitLab Subscriptions > Fetch a subscription
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::GitLab::Configuration.new
+      #   config.token = 'test123abc'
+      #   client = Readiness::GitLab::Client.new(config)
+      #   namespace = Readiness::GitLab::Namespaces.find!(client, 123)
+      #   sub = Readiness::GitLab::Namespaces.subscription(client, namespace)
+      #   pp sub['plan']['code']
+      #   # => "ultimate"
+      def self.subscription(client, namespace)
+        response = client.connection.get "internal/gitlab_subscriptions/namespaces/#{namespace.id}/gitlab_subscription"
+        handle_request_error(0, 'GitLab', response.status,  { action: 'get', id: namespace.id }) unless response.status == 200
+        Oj.load(response.body)
+      end
+    end
+  end
+end