gitlab-customer-support-operations_gitlab 1.0.0

data/lib/support_ops_gitlab/gitlab/commits.rb

@@ -0,0 +1,198 @@
+# frozen_string_literal: true
+
+# Defines the module SupportOps.
+module SupportOps
+  # Defines the module GitLab
+  module GitLab
+    ##
+    # Defines the class Commits within the module {SupportOps::GitLab}.
+    #
+    # @author Jason Colyer
+    # @since 1.0.0
+    # @attr [Array] actions An array of action hashes to commit as a batch; see API documentation on gitlab for more information (create only)
+    # @attr [String] authored_date
+    # @attr [String] author_email
+    # @attr [String] author_name
+    # @attr [String] commit_message
+    # @attr [String] committed_date
+    # @attr [String] committer_email
+    # @attr [String] committer_name
+    # @attr [String] created_at
+    # @attr [Hash] extended_trailers
+    # @attr [Boolean] force
+    # @attr [String] id
+    # @attr [Hash] last_pipeline
+    # @attr [String] message
+    # @attr [Array] parent_ids
+    # @attr [Integer] project_id
+    # @attr [String] short_id
+    # @attr [String] start_branch
+    # @attr [Integer] start_project
+    # @attr [String] start_sha
+    # @attr [Hash] stats
+    # @attr [String] status
+    # @attr [String] title
+    # @attr [Boolean] trailers Git trailers for a commit
+    # @attr [String] web_url
+    # @todo Document attributes
+    # @todo Stuff at https://docs.gitlab.com/api/commits/
+    class Commits < SupportOps::GitLab::Base
+      # @!parse
+      #   # Creates a commit
+      #   # 
+      #   # @author Jason Colyer
+      #   # @since 1.0.0
+      #   # @return [Object] Instance of {SupportOps::GitLab::Commits}
+      #   # @note This is inherited from {SupportOps::GitLab::Base#save!}
+      #   # @see
+      #   #   https://docs.gitlab.com/api/commits/#create-a-commit-with-multiple-files-and-actions
+      #   #   GitLab API > Commits > Create a commit with multiple files and actions
+      #   # @example
+      #   #   require 'support_ops_gitlab'
+      #   #
+      #   #   SupportOps::GitLab::Configuration.configure do |config|
+      #   #     config.token = ENV.fetch('GL_TOKEN')
+      #   #     config.url = 'https://gitlab.com/api/v4'
+      #   #   end
+      #   #
+      #   #   new_commit = SupportOps::GitLab::Commits.new
+      #   #   new_commit.branch = 'master'
+      #   #   new_commit.commit_message = 'Changing some stuff'
+      #   #   new_commit.project_id = 123456
+      #   #   new_commit.actions = [
+      #   #     { action: 'create', file_path: 'foo/bar', content: 'some content' },
+      #   #     { action: 'update', file_path: 'foo/bar5', content: 'new content' },
+      #   #     { action: 'delete', file_path': 'foo/bar2' },
+      #   #     { action: 'move', file_path: 'foo/bar3', previous_path: 'foo/bar4', content: 'some content' },
+      #   #     { action: 'chmod', file_path: 'foo/bar5', execute_filemode: true }
+      #   #   ]
+      #   #
+      #   #   new_commit.save!
+      #   #
+      #   #   pp new_commit.id
+      #   #   # => "ed899a2f4b50b4370feeea94676502b42383c746"
+      #   def save!; end
+      define_attributes :actions, :authored_date, :author_email, :author_name,
+                        :commit_message, :committed_date, :committer_email,
+                        :committer_name, :created_at, :extended_trailers,
+                        :force, :id, :last_pipeline, :message, :parent_ids,
+                        :project_id, :short_id, :start_branch, :start_project,
+                        :start_sha, :stats, :status, :title, :trailers, :web_url
+      readonly_attributes :authored_date, :committed_date, :committer_email,
+                          :committer_name, :created_at, :extended_trailers,
+                          :id, :last_pipeline, :message, :parent_ids,
+                          :project_id, :short_id, :stats, :status, :title,
+                          :trailers, :web_url
+
+      ##
+      # List repository commits
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @overload list(key: value)
+      #   @param project_id [Integer required] The project ID to look in
+      #   @param all [Boolean optional] Retrieve every commit from the
+      #     repository; when set to true, the ref_name parameter is ignored
+      #   @param author [String optional] Search commits by commit author
+      #   @param first_parent [Boolean optional] Follow only the first parent
+      #     commit upon seeing a merge commit
+      #   @param order [String optional] List commits in order; possible values:
+      #     default, topo; defaults to default, the commits are shown in reverse
+      #     chronological order
+      #   @param path [String optional] The file path
+      #   @param ref_name [String optional] The name of a repository branch, tag
+      #     or revision range, or if not given the default branch
+      #   @param since [String optional] Only commits after or on this date are
+      #     returned in ISO 8601 format YYYY-MM-DDTHH:MM:SSZ
+      #   @param until [String optional] Only commits before or on this date are
+      #     returned in ISO 8601 format YYYY-MM-DDTHH:MM:SSZ
+      #   @param limit [Integer optional] The limit to the number of users
+      #     returned. Default to 0 (i.e. no limit)
+      # @return [Array]
+      # @see
+      #   https://docs.gitlab.com/api/commits/#list-repository-commits
+      #   GitLab API > Commits > List repository commits
+      # @see SupportOps::GitLab::Configuration Setting up a client
+      # @example
+      #   require 'support_ops_gitlab'
+      #
+      #   SupportOps::GitLab::Configuration.configure do |config|
+      #     config.url = 'https://gitlab.example.com/api/v4'
+      #     config.token = 'abc123'
+      #   end
+      #
+      #   commits = SupportOps::GitLab::Commits.list(project_id: 123)
+      #   pp commits.count
+      #   # => 115
+      #   pp commits.last.title
+      #   # => "Aweomse commit"
+      def self.list(**args)
+        args[:project_id] = nil unless args[:project_id]
+        raise 'You have to provide a project_id' if args[:project_id].nil?
+        args[:all] = nil unless args[:all]
+        args[:author] = nil unless args[:author]
+        args[:first_parent] = nil unless args[:first_parent]
+        args[:order] = nil unless args[:order]
+        args[:path] = nil unless args[:path]
+        args[:ref_name] = nil unless args[:ref_name]
+        args[:since] = nil unless args[:since]
+        args[:until] = nil unless args[:until]
+        args[:limit] = 0 unless args[:limit]
+        params = 'with_stats=true&trailers=true&'
+        params += "all=#{args[:all]}&" unless args[:all].nil?
+        params += "author=#{args[:author]}&" unless args[:author].nil?
+        params += "first_parent=#{args[:first_parent]}&" unless args[:first_parent].nil?
+        params += "order=#{args[:order]}&" unless args[:order].nil?
+        params += "path=#{args[:path]}&" unless args[:path].nil?
+        params += "ref_name=#{args[:ref_name]}&" unless args[:ref_name].nil?
+        params += "since=#{args[:since]}&" unless args[:since].nil?
+        params += "until=#{args[:until]}&" unless args[:until].nil?
+        array = []
+        page = 1
+        loop do
+          response = client.connection.get("projects/#{args[:project_id]}/repository/commits?#{params}&page=#{page}&per_page=100")
+          body = Oj.load(response.body)
+          array += body.map do |c|
+            c['project_id'] = args[:project_id]
+            Commits.new(c)
+          end
+          break if args[:limit].to_i.positive? && array.count >= args[:limit].to_i
+          break if body.count < 100
+
+          page += 1
+        end
+        return array if args[:limit].to_i.zero?
+        
+        array.first(args[:limit].to_i)
+      end
+
+      private
+
+      ##
+      # @private
+      def create_record
+        raise 'You have to provide a project_id' if self.project_id.nil?
+        raise 'You have to provide actions' if self.actions.nil?
+        raise 'You have to provide actions as an array' unless self.actions.is_a? Array
+        raise 'You have to provide a branch' if self.branch.nil?
+        raise 'You have to provide a commit_message' if self.commit_message.nil?
+        data = {
+          actions: self.actions,
+          branch: self.branch,
+          commit_message: self.commit_message
+        }
+        data[:author_email] = self.author_email unless self.author_email.nil?
+        data[:author_name] = self.author_name unless self.author_name.nil?
+        data[:force] = self.force unless self.force.nil?
+        data[:start_branch] = self.start_branch unless self.start_branch.nil?
+        data[:start_project] = self.start_project unless self.start_project.nil?
+        data[:start_sha] = self.start_sha unless self.start_sha.nil?
+        response = self.client.connection.post("projects/#{self.project_id}/repository/commits", data.to_json)
+        body = Oj.load(response.body)
+        raise "Failed to create commit => #{body}" unless response.status == 200
+        body['project_id'] = self.project_id
+        body
+      end
+    end
+  end
+end

data/lib/support_ops_gitlab/gitlab/configuration.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+# Defines the module SupportOps.
+module SupportOps
+  # Defines the module GitLab
+  module GitLab
+    ##
+    # Defines the module Configuration within the module {SupportOps::GitLab}.
+    #
+    # @author Jason Colyer
+    # @since 1.0.0
+    module Configuration
+      ##
+      # Setup a Zendesk client configuration
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @overload configure(key: value)
+      #   @param job_token [String] See {Config#job_token}
+      #   @param retry_backoff [Integer] See {Config#retry_backoff}
+      #   @param retry_exceptions [Array] See {Config#retry_exceptions}
+      #   @param retry_interval [Integer] See {Config#retry_interval}
+      #   @param retry_max [Integer] See {Config#retry_max}
+      #   @param retry_randomness [Integer] See {Config#retry_randomness}
+      #   @param token [String] See {Config#token}
+      #   @param url [String] See {Config#url}
+      # @example
+      #   require 'support_ops_zendesk'
+      #
+      #   SupportOps::GitLab::Configuration.configure do |config|
+      #     config.url = 'https://gitlab.com/api/v4'
+      #     config.token = 'abc123'
+      #   end
+      def self.configure
+        yield config
+      end
+
+      def self.config
+        @config ||= Config.new
+      end
+
+      def self.reset!
+        @config = Config.new
+      end
+
+      ##
+      # Defined the class Config within the module {SupportOps::GitLab::Configuration}
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @attr [String] job_token The job token to use for authentication
+      # @attr [Integer] retry_backoff  multiplier applied to the retry_interval after each retry attempt, causing exponential backoff. Defaults to 2
+      # @attr [Array] retry_exceptions Specifies which types of exceptions or errors should trigger the retry mechanism.
+      # @attr [Integer] retry_interval The base time interval (typically in seconds or milliseconds) between retry attempts. Defaults to 1
+      # @attr [Integer] retry_max The maximum number of retry attempts that will be made when an operation fails. Defaults to 5
+      # @attr [Float] retry_randomness Adds a random element to the retry interval to prevent "thundering herd" problems where many systems retry simultaneously. Defaults to 0.5
+      # @attr [String] token The token to use for authentication
+      # @attr [String] url The API url to connect to, it should alwaus be in the format of 'https:\/\/YOUR_DOMAIN.com/api/v4' (note the lack of a trailing /)
+      class Config
+        attr_accessor :url, :job_token, :token, :retry_max, :retry_interval,
+                      :retry_randomness, :retry_backoff, :retry_exceptions,
+
+        def initialize
+          @retry_backoff = 2
+          @retry_exceptions = Faraday::Retry::Middleware::DEFAULT_EXCEPTIONS + [Faraday::ConnectionFailed]
+          @retry_interval = 1
+          @retry_max = 5
+          @retry_randomness = 0.5
+        end
+
+        def client
+          @client ||= Client.new(
+            job_token: job_token,
+            retry_max: retry_max,
+            retry_interval: retry_interval,
+            retry_randomness: retry_randomness,
+            retry_backoff: retry_backoff,
+            retry_exceptions: retry_exceptions,
+            url: url,
+            token: token
+          )
+        end
+      end
+    end
+  end
+end

data/lib/support_ops_gitlab/gitlab/epics.rb

@@ -0,0 +1,325 @@
+# frozen_string_literal: true
+
+# Defines the module SupportOps.
+module SupportOps
+  # Defines the module GitLab
+  module GitLab
+    ##
+    # Defines the class Epics within the module {SupportOps::GitLab}.
+    #
+    # @author Jason Colyer
+    # @since 1.0.0
+    # @attr [Array] add_labels Comma-separated label names to add to an issue
+    # @attr [Hash] author Information about the epic author
+    # @attr [String] closed_at When the epic was closed
+    # @attr [String] color The color of the epic
+    # @attr [Boolean] confidential Whether the epic should be confidential
+    # @attr [String] created_at When the epic was created
+    # @attr [String] description The description of the epic
+    # @attr [Integer] downvotes The number of downvotes on an epic
+    # @attr [String] due_date When the epic is due
+    # @attr [String] due_date_fixed The fixed due date of an epic
+    # @attr [String] due_date_from_inherited_source When the epic is due (inherited from the source of the epic)
+    # @attr [Boolean] due_date_is_fixed Whether due date should be sourced from due_date_fixed or from milestones
+    # @attr [Integer] group_id The ID of the epic's group
+    # @attr [Integer] id the ID of the epic
+    # @attr [Integer] iid The internal ID of the epic
+    # @attr [Boolean] imported If the epic was imported
+    # @attr [String] imported_from Where the epic was imported from
+    # @attr [Array] labels The comma-separated list of labels
+    # @attr [Hash] _links Various links related to the epic
+    # @attr [Integer] parent_id The ID of a parent epic
+    # @attr [Integer] parent_iid The internal ID of a parent epic
+    # @attr [String] reference The reference tag for the epic
+    # @attr [Hash] references Reference tags for the epic
+    # @attr [Array] remove_labels Comma-separated label names to remove from an issue
+    # @attr [String] start_date The start date of the epic
+    # @attr [String] start_date_fixed The fixed start date of an epic
+    # @attr [String] start_date_from_inherited_source The start date of the epic (inherited from the source of the epic)
+    # @attr [Boolean] start_date_is_fixed Whether start date should be sourced from start_date_fixed or from milestones
+    # @attr [String] state The current state of the epic
+    # @attr [String] state_event State event for an epic; Set 'close' to close the epic and 'reopen' to reopen it
+    # @attr [Boolean] subscribed If the authenticated user is subscribed to the epic
+    # @attr [String] title The title of the epic
+    # @attr [String] updated_at When the epic was updated
+    # @attr [Integer] upvotes The number of upvotes on an epic
+    # @attr [String] web_url The URL of the epic
+    # @todo Single epic > https://docs.gitlab.com/api/epics/#single-epic
+    # @todo Create a to-do item > https://docs.gitlab.com/api/epics/#create-a-to-do-item
+    class Epics < SupportOps::GitLab::Base
+      # @!parse
+      #   # Creates/updates an epic
+      #   # 
+      #   # @author Jason Colyer
+      #   # @since 1.0.0
+      #   # @return [Object] Instance of {SupportOps::GitLab::Epics}
+      #   # @note This is inherited from {SupportOps::GitLab::Base#save!}
+      #   # @see
+      #   #   https://docs.gitlab.com/api/epics/#new-epic
+      #   #   GitLab API > Epics > New epic
+      #   # @see
+      #   #   https://docs.gitlab.com/api/epics/#update-epic
+      #   #   GitLab API > Epics > Update epic
+      #   # @example
+      #   #   require 'support_ops_gitlab'
+      #   #
+      #   #   SupportOps::GitLab::Configuration.configure do |config|
+      #   #     config.token = ENV.fetch('GL_TOKEN')
+      #   #     config.url = 'https://gitlab.com/api/v4'
+      #   #   end
+      #   #
+      #   #   new_epic = SupportOps::GitLab::Epics.new
+      #   #   new_epic.title = 'Epic'
+      #   #   new_epic.description = 'Epic description'
+      #   #   new_epic.parent_id = 29
+      #   #   new_epic.group_id = 1
+      #   #
+      #   #   new_epic.save!
+      #   #
+      #   #   pp new_epic.id
+      #   #   # => 33
+      #   # @example
+      #   #   require 'support_ops_gitlab'
+      #   #
+      #   #   SupportOps::GitLab::Configuration.configure do |config|
+      #   #     config.token = ENV.fetch('GL_TOKEN')
+      #   #     config.url = 'https://gitlab.com/api/v4'
+      #   #   end
+      #   #
+      #   #   epics = SupportOps::GitLab::Epics.list(group_id: 1)
+      #   #   existing_epic = epics.detect { |e| e.id == 33 }
+      #   #   existing_epic.title = 'Epic v2'
+      #   #
+      #   #   existing_epic.save!
+      #   #
+      #   #   pp existing_epic.title
+      #   #   # => "Epic v2"
+      #   def save!; end
+      # @!parse
+      #   # Deletes an epic
+      #   # 
+      #   # @author Jason Colyer
+      #   # @since 1.0.0
+      #   # @return [Boolean]
+      #   # @note This is inherited from {SupportOps::GitLab::Base#delete!}
+      #   # @see
+      #   #   https://docs.gitlab.com/api/epics/#delete-epic
+      #   #   GitLab API > Epics > Delete epic
+      #   # @example
+      #   #   require 'support_ops_gitlab'
+      #   #
+      #   #   SupportOps::GitLab::Configuration.configure do |config|
+      #   #     config.token = ENV.fetch('GL_TOKEN')
+      #   #     config.url = 'https://gitlab.com/api/v4'
+      #   #   end
+      #   #
+      #   #   epics = SupportOps::GitLab::Epics.list(group_id: 1)
+      #   #   existing_epic = epics.detect { |e| e.id == 33 }
+      #   #   existing_epic.delete!
+      #   def delete!; end
+      # @!parse
+      #   # List issues on an epic
+      #   #
+      #   # @author Jason Colyer
+      #   # @since 1.0.0
+      #   # @return [Boolean]
+      #   # @note This is inherited from {SupportOps::GitLab::Base#issues}
+      #   # @see
+      #   #   https://docs.gitlab.com/api/epic_issues/#list-issues-for-an-epic
+      #   #   GitLab API > Epics > List issues for an epic
+      #   # @example
+      #   #   require 'support_ops_gitlab'
+      #   #
+      #   #   SupportOps::GitLab::Configuration.configure do |config|
+      #   #     config.token = ENV.fetch('GL_TOKEN')
+      #   #     config.url = 'https://gitlab.com/api/v4'
+      #   #   end
+      #   #
+      #   #   epics = SupportOps::GitLab::Epics.list(group_id: 1)
+      #   #   existing_epic = epics.detect { |e| e.id == 33 }
+      #   #   issues = existing_epic.issues
+      #   #   pp issues.count
+      #   #   # => 6
+      #   def issues; end
+      # @!parse
+      #   # List notes on an epic
+      #   #
+      #   # @author Jason Colyer
+      #   # @since 1.0.0
+      #   # @return [Boolean]
+      #   # @note This is inherited from {SupportOps::GitLab::Base#notes}
+      #   # @see
+      #   #   https://docs.gitlab.com/api/notes/#list-all-epic-notes
+      #   #   GitLab API > Notes (comments) > List all epic notes
+      #   # @example
+      #   #   require 'support_ops_gitlab'
+      #   #
+      #   #   SupportOps::GitLab::Configuration.configure do |config|
+      #   #     config.token = ENV.fetch('GL_TOKEN')
+      #   #     config.url = 'https://gitlab.com/api/v4'
+      #   #   end
+      #   #
+      #   #   epics = SupportOps::GitLab::Epics.list(group_id: 1)
+      #   #   existing_epic = epics.detect { |e| e.id == 33 }
+      #   #   notes = existing_epic.notes
+      #   #   pp notes.count
+      #   #   # => 3
+      #   def notes; end
+      define_attributes :add_labels, :author, :closed_at, :color, :confidential,
+                        :created_at, :description, :downvotes, :due_date,
+                        :due_date_fixed, :due_date_from_inherited_source,
+                        :due_date_is_fixed,
+                        :group_id, :id, :iid, :imported,
+                        :imported_from, :labels, :_links, :parent_id,
+                        :parent_iid, :reference, :references, :remove_labels,
+                        :start_date, :start_date_fixed,
+                        :start_date_from_inherited_source,
+                        :start_date_is_fixed,
+                        :state, :state_event, :subscribed, :title, :updated_at,
+                        :upvotes, :web_url
+      readonly_attributes :author, :closed_at, :created_at, :downvotes,
+                          :due_date, :due_date_from_inherited_source, :group_id,
+                          :id, :iid, :imported, :imported_from, :_links,
+                          :parent_iid, :reference, :references, :start_date,
+                          :start_date_from_inherited_source, :state,
+                          :subscribed, :updated_at, :upvotes, :web_url
+
+      ##
+      # Lists all epics keys for a group
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @overload list(key: value)
+      #   @param group_id [Integer required] The group ID to get the epics from
+      #   @param author_id [Integer optional] Return epics created by the given user id
+      #   @param author_username [String optional] Return epics created by the user with the given username
+      #   @param labels [String optional] Return epics matching a comma-separated list of labels names
+      #   @param order_by [String optional] Return epics ordered by created_at, updated_at, or title fields
+      #   @param sort [String optional] Return epics sorted in asc or desc order
+      #   @param search [String optional] Search epics against their title and description
+      #   @param state [String optional] Search epics against their state, possible filters: opened, closed, and all
+      #   @param created_after [String optional] Return epics created on or after the given time; expected in ISO 8601 format (2019-03-15T08:00:00Z)
+      #   @param created_before [String optional] Return epics created on or before the given time; expected in ISO 8601 format (2019-03-15T08:00:00Z)
+      #   @param updated_after [String optional] Return epics updated on or after the given time; expected in ISO 8601 format (2019-03-15T08:00:00Z)
+      #   @param updated_before [String optional] Return epics updated on or before the given time; expected in ISO 8601 format (2019-03-15T08:00:00Z)
+      #   @param include_ancestor_groups [xxx optional] Include epics from the requested group’s ancestors
+      #   @param include_descendant_groups [xxx optional] Include epics from the requested group’s descendants
+      #   @param my_reaction_emoji [String optional] Return epics reacted by the authenticated user by the given emoj
+      # @return [Array]
+      # @see
+      #   https://docs.gitlab.com/api/epics/#list-epics-for-a-group
+      #   GitLab API > Epics > List epics for a group
+      # @see SupportOps::GitLab::Configuration Setting up a client
+      # @example
+      #   require 'support_ops_gitlab'
+      #
+      #   SupportOps::GitLab::Configuration.configure do |config|
+      #     config.url = 'https://gitlab.example.com/api/v4'
+      #     config.token = 'abc123'
+      #   end
+      #
+      #   epics = SupportOps::GitLab::Epics.list(group_id: 123456)
+      #   pp epics.count
+      #   # => 30
+      #   pp epics.last.due_date
+      #   # => "2018-07-31"
+      def self.list(**args)
+        args[:group_id] = nil unless args[:group_id]
+        raise 'You have to provide a group_id' if args[:group_id].nil?
+        args[:author_id] = nil unless args[:author_id]
+        args[:author_username] = nil unless args[:author_username]
+        args[:labels] = nil unless args[:labels]
+        args[:order_by] = nil unless args[:order_by]
+        args[:sort] = nil unless args[:sort]
+        args[:search] = nil unless args[:search]
+        args[:state] = nil unless args[:state]
+        args[:created_after] = nil unless args[:created_after]
+        args[:created_before] = nil unless args[:created_before]
+        args[:updated_after] = nil unless args[:updated_after]
+        args[:updated_before] = nil unless args[:updated_before]
+        args[:include_ancestor_groups] = nil unless args[:include_ancestor_groups]
+        args[:include_descendant_groups] = nil unless args[:include_descendant_groups]
+        args[:my_reaction_emoji] = nil unless args[:my_reaction_emoji]
+        params = ''
+        params += "active=#{args[:active]}&" unless args[:active].nil?
+        params += "author_id=#{args[:author_id]}&" unless args[:author_id].nil?
+        params += "author_username=#{args[:author_username]}&" unless args[:author_username].nil?
+        params += "labels=#{args[:labels]}&" unless args[:labels].nil?
+        params += "order_by=#{args[:order_by]}&" unless args[:order_by].nil?
+        params += "sort=#{args[:sort]}&" unless args[:sort].nil?
+        params += "search=#{args[:search]}&" unless args[:search].nil?
+        params += "state=#{args[:state]}&" unless args[:state].nil?
+        params += "created_after=#{args[:created_after]}&" unless args[:created_after].nil?
+        params += "created_before=#{args[:created_before]}&" unless args[:created_before].nil?
+        params += "updated_after=#{args[:updated_after]}&" unless args[:updated_after].nil?
+        params += "updated_before=#{args[:updated_before]}&" unless args[:updated_before].nil?
+        params += "include_ancestor_groups=#{args[:include_ancestor_groups]}&" unless args[:include_ancestor_groups].nil?
+        params += "include_descendant_groups=#{args[:include_descendant_groups]}&" unless args[:include_descendant_groups].nil?
+        params += "my_reaction_emoji=#{args[:my_reaction_emoji]}&" unless args[:my_reaction_emoji].nil?
+        array = []
+        page = 1
+        loop do
+          response = client.connection.get("groups/#{args[:group_id]}/epics?#{params}&page=#{page}&per_page=100")
+          body = Oj.load(response.body)
+          array += body.map { |e| Epics.new(e) }
+          break if body.count < 100
+
+          page += 1
+        end
+        array
+      end
+
+      private
+
+      ##
+      # @private
+      def create_record
+        response = self.client.connection.post("groups/#{self.group_id}/epics", attributes_for_save.to_json)
+        body = Oj.load(response.body)
+        raise "Failed to create epic => #{body}" if response.status != 201
+        body
+      end
+
+      ##
+      # @private
+      def update_record
+        raise "Failed to update epic => You didn't change anything in the object" if attributes_for_save.keys == [:id]
+        response = self.client.connection.put("groups/#{self.group_id}/epics/#{self.iid}", attributes_for_save.to_json)
+        body = Oj.load(response.body)
+        raise "Failed to update epic #{self.id} => #{body}" if response.status != 200
+        body
+      end
+
+      ##
+      # @private
+      def delete_record
+        response = self.client.connection.delete("groups/#{self.group_id}/epics/#{self.iid}")
+        body = Oj.load(response.body)
+        raise "Failed to delete epic #{self.id} => #{body}" unless response.status == 204
+        true
+      end
+
+      ##
+      # @private
+      def issues_record
+        array = []
+        page = 1
+        loop do
+          response = client.connection.get("groups/#{self.group_id}/epics/#{self.id}/issues?page=#{page}&per_page=100")
+          body = Oj.load(response.body)
+          array += body.map { |i| Issues.new(i) }
+          break if body.count < 100
+
+          page += 1
+        end
+        array
+      end
+
+      ##
+      # @private
+      def notes_record
+        Notes.list(type: 'Epic', type_id: self.id, group_id: self.group_id)
+      end
+    end
+  end
+end