labclient 0.1.0

data/lib/labclient/awards/merge_requests/client.rb

@@ -0,0 +1,17 @@
+# Top namespace
+module LabClient
+  # Inspect Helper
+  class MergeRequestAwards < Common
+    include ClassHelpers
+  end
+end
+
+# Top namespace
+module LabClient
+  # Specifics
+  class Awards < Common
+    def merge_requests
+      MergeRequestAwards.new(client)
+    end
+  end
+end

data/lib/labclient/awards/merge_requests/create.rb

@@ -0,0 +1,23 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class MergeRequestAwards < Common
+    doc 'MergeRequests' do
+      title 'Create'
+      desc 'Create an award emoji [Project, MergeRequest IID, Name]'
+      example 'client.awards.merge_requests.create(16, 1, :blowfish)'
+      result <<~DOC
+        => #<Award id: 2 name: blowfish>
+      DOC
+    end
+
+    def create(project_id, merge_request_id, name)
+      project_id = format_id(project_id)
+      merge_request_id = format_id(merge_request_id)
+
+      query = { name: name }
+
+      client.request(:post, "projects/#{project_id}/merge_requests/#{merge_request_id}/award_emoji", Award, query)
+    end
+  end
+end

data/lib/labclient/awards/merge_requests/delete.rb

@@ -0,0 +1,20 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class MergeRequestAwards < Common
+    doc 'MergeRequests' do
+      title 'Delete'
+      desc 'Sometimes it’s just not meant to be and you’ll have to remove the award. [Project ID, MergeRequest IID, Award ID]'
+      example 'client.awards.merge_requests.delete(16, 2, 2)'
+    end
+
+    # Delete
+    def delete(project_id, merge_request_id, award_id)
+      project_id = format_id(project_id)
+      merge_request_id = format_id(merge_request_id)
+      award_id = format_id(award_id)
+
+      client.request(:delete, "projects/#{project_id}/merge_requests/#{merge_request_id}/award_emoji/#{award_id}")
+    end
+  end
+end

data/lib/labclient/awards/merge_requests/list.rb

@@ -0,0 +1,22 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class MergeRequestAwards < Common
+    @group_name = 'Awards'
+    doc 'MergeRequests' do
+      title 'List'
+      desc 'Get a list of all award emoji for a specified awardable. [Project ID, MergeRequest IID]'
+      example 'client.awards.merge_requests.list(16, 1)'
+      result <<~DOC
+        => [#<Award id: 2dc2a8d>, .. ]
+      DOC
+    end
+
+    def list(project_id, merge_request_id)
+      project_id = format_id(project_id)
+      merge_request_id = format_id(merge_request_id)
+
+      client.request(:get, "projects/#{project_id}/merge_requests/#{merge_request_id}/award_emoji", Award)
+    end
+  end
+end

data/lib/labclient/awards/merge_requests/show.rb

@@ -0,0 +1,22 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class MergeRequestAwards < Common
+    doc 'MergeRequests' do
+      title 'Show'
+      desc 'Get a single award emoji [Project ID, MergeRequest IID, Award ID]'
+      example 'client.awards.merge_requests.show(16, 1, 1)'
+      result <<~DOC
+        => #<Award id: 1 name: badminton>
+      DOC
+    end
+
+    def show(project_id, merge_request_id, award_id)
+      project_id = format_id(project_id)
+      merge_request_id = format_id(merge_request_id)
+      award_id = format_id(award_id)
+
+      client.request(:get, "projects/#{project_id}/merge_requests/#{merge_request_id}/award_emoji/#{award_id}", Award)
+    end
+  end
+end

data/lib/labclient/awards/snippets/client.rb

@@ -0,0 +1,17 @@
+# Top namespace
+module LabClient
+  # Inspect Helper
+  class SnippetAwards < Common
+    include ClassHelpers
+  end
+end
+
+# Top namespace
+module LabClient
+  # Specifics
+  class Awards < Common
+    def snippets
+      SnippetAwards.new(client)
+    end
+  end
+end

data/lib/labclient/awards/snippets/create.rb

@@ -0,0 +1,23 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class SnippetAwards < Common
+    doc 'Snippets' do
+      title 'Create'
+      desc 'Create an award emoji [Project, Snippet ID, Name]'
+      example 'client.awards.snippets.create(16, 1, :blowfish)'
+      result <<~DOC
+        => #<Award id: 2 name: blowfish>
+      DOC
+    end
+
+    def create(project_id, snippet_id, name)
+      project_id = format_id(project_id)
+      snippet_id = format_id(snippet_id)
+
+      query = { name: name }
+
+      client.request(:post, "projects/#{project_id}/snippets/#{snippet_id}/award_emoji", Award, query)
+    end
+  end
+end

data/lib/labclient/awards/snippets/delete.rb

@@ -0,0 +1,20 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class SnippetAwards < Common
+    doc 'Snippets' do
+      title 'Delete'
+      desc 'Sometimes it’s just not meant to be and you’ll have to remove the award. [Project ID, Snippet ID, Award ID]'
+      example 'client.awards.snippets.delete(16, 2, 2)'
+    end
+
+    # Delete
+    def delete(project_id, snippet_id, award_id)
+      project_id = format_id(project_id)
+      snippet_id = format_id(snippet_id)
+      award_id = format_id(award_id)
+
+      client.request(:delete, "projects/#{project_id}/snippets/#{snippet_id}/award_emoji/#{award_id}")
+    end
+  end
+end

data/lib/labclient/awards/snippets/list.rb

@@ -0,0 +1,22 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class SnippetAwards < Common
+    @group_name = 'Awards'
+    doc 'Snippets' do
+      title 'List'
+      desc 'Get a list of all award emoji for a specified awardable. [Project ID, Snippet ID]'
+      example 'client.awards.snippets.list(16, 1)'
+      result <<~DOC
+        => [#<Award id: 2dc2a8d>, .. ]
+      DOC
+    end
+
+    def list(project_id, snippet_id)
+      project_id = format_id(project_id)
+      snippet_id = format_id(snippet_id)
+
+      client.request(:get, "projects/#{project_id}/snippets/#{snippet_id}/award_emoji", Award)
+    end
+  end
+end

data/lib/labclient/awards/snippets/show.rb

@@ -0,0 +1,22 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class SnippetAwards < Common
+    doc 'Snippets' do
+      title 'Show'
+      desc 'Get a single award emoji [Project ID, Snippet ID, Award ID]'
+      example 'client.awards.snippets.show(16, 1, 1)'
+      result <<~DOC
+        => #<Award id: 1 name: badminton>
+      DOC
+    end
+
+    def show(project_id, snippet_id, award_id)
+      project_id = format_id(project_id)
+      snippet_id = format_id(snippet_id)
+      award_id = format_id(award_id)
+
+      client.request(:get, "projects/#{project_id}/snippets/#{snippet_id}/award_emoji/#{award_id}", Award)
+    end
+  end
+end

data/lib/labclient/branches/branch.rb

@@ -0,0 +1,15 @@
+# Top namespace
+module LabClient
+  # Inspect Helper
+  class Branch < Klass
+    include ClassHelpers
+
+    def inspect
+      "#<Branch name: #{name}>"
+    end
+
+    def commit
+      Commit.new(@table[:commit], response, client)
+    end
+  end
+end

data/lib/labclient/branches/delete.rb

@@ -0,0 +1,24 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class Branches < Common
+    doc 'Delete' do
+      desc 'Delete a single project repository branch. [Project ID, Branch]'
+      example 'client.branches.delete(264, :feature)'
+    end
+
+    doc 'Delete' do
+      desc 'via Project'
+      example <<~DOC
+        project = client.projects.show(264)
+        project.branch_delete(:feature)
+      DOC
+    end
+
+    def delete(project_id, branch_id)
+      project_id = format_id(project_id)
+
+      client.request(:delete, "projects/#{project_id}/repository/branches/#{branch_id}")
+    end
+  end
+end

data/lib/labclient/branches/delete_merged.rb

@@ -0,0 +1,25 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class Branches < Common
+    doc 'Delete' do
+      title 'Merged'
+      desc 'Will delete all branches that are merged into the project’s default branch. [Project ID]'
+      example 'client.branches.branch_delete_merged(264, :feature)'
+      result '=> {:message=>"202 Accepted"}'
+    end
+
+    doc 'Delete' do
+      desc 'via Project'
+      example <<~DOC
+        project = client.projects.show(264)
+        project.branch_delete_merged(:feature)
+      DOC
+    end
+
+    def delete_merged(project_id)
+      project_id = format_id(project_id)
+      client.request(:delete, "projects/#{project_id}/repository/merged_branches")
+    end
+  end
+end

data/lib/labclient/branches/list.rb

@@ -0,0 +1,35 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class Branches < Common
+    doc 'List' do
+      desc 'Get a list of repository branches from a project, sorted by name alphabetically. [Project ID, String]'
+      example 'client.branches.list(264)'
+      result '[#<Branch name: feature>, #<Branch name: master>]'
+
+      markdown <<~DOC
+        Search: You can use ^term and term$ to find branches that begin and end with term respectively.
+      DOC
+    end
+
+    doc 'List' do
+      desc 'via Project'
+      example <<~DOC
+        project = client.projects.show(264)
+        project.branches
+      DOC
+    end
+
+    def list(project_id, search = nil)
+      query = if search.nil?
+                nil
+              else
+                { search: search }
+              end
+
+      project_id = format_id(project_id)
+
+      client.request(:get, "projects/#{project_id}/repository/branches", Branch, query)
+    end
+  end
+end

data/lib/labclient/branches/show.rb

@@ -0,0 +1,24 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class Branches < Common
+    doc 'Show' do
+      desc 'Get a single project repository branch. [Project ID, Branch]'
+      example 'client.branches.show(264, :master)'
+      result '#<Branch name: master>'
+    end
+
+    doc 'Show' do
+      desc 'via Project'
+      example <<~DOC
+        project = client.projects.show(264)
+        project.branch(:master)
+      DOC
+    end
+
+    def show(project_id, branch_id)
+      project_id = format_id(project_id)
+      client.request(:get, "projects/#{project_id}/repository/branches/#{branch_id}", Branch)
+    end
+  end
+end

data/lib/labclient/broadcast_messages/broadcast_message.rb

@@ -0,0 +1,31 @@
+# Top namespace
+module LabClient
+  # Inspect Helper
+  class BroadcastMessage < Klass
+    include ClassHelpers
+
+    def inspect
+      active_text = active ? 'Active' : 'Inactive'
+      "#<BroadcastMessage id: #{id}, #{active_text}>"
+    end
+
+    def update(query = {})
+      query[:starts_at] = query[:starts_at].to_time.iso8601 if format_time?(query[:starts_at])
+      query[:ends_at] = query[:ends_at].to_time.iso8601 if format_time?(query[:ends_at])
+
+      update_self client.broadcast_messages.update(id, query)
+    end
+
+    date_time_attrs %i[ends_at starts_at]
+
+    def delete
+      client.broadcast_messages.delete id
+    end
+
+    help do
+      subtitle 'Broadcast Message'
+      option 'delete', 'Delete this broadcast message.'
+      option 'update', 'Update this broadcast message.'
+    end
+  end
+end

data/lib/labclient/broadcast_messages/create.rb

@@ -0,0 +1,66 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class BroadcastMessages < Common
+    doc 'Create' do
+      desc 'Create a new broadcast message'
+      markdown <<~DOC
+        | Attribute  | Type     | Required | Description                                           |
+        |------------| ---------|----------|-------------------------------------------------------|
+        | message    | string   | yes      | Message to display.                                   |
+        | starts_at  | datetime | no       | Starting time (defaults to current time).             |
+        | ends_at    | datetime | no       | Ending time (defaults to one hour from current time). |
+        | color      | string   | no       | Background color hex code.                            |
+        | font       | string   | no       | Foreground color hex code.                            |
+      DOC
+    end
+
+    doc 'Create' do
+      example <<~DOC
+        client.broadcast_messages.create(message: "Alert!")
+      DOC
+      result <<~DOC
+        => #<BroadcastMessage id: 3, Active>
+      DOC
+    end
+
+    doc 'Create' do
+      title 'DateTime Helpers'
+      markdown 'Both `:starts_at` and `:ends_at` can be used with Date or Time objects.   <small>_responds_to: `to_time`_</small>'
+
+      example <<~DOC
+        result = client.broadcast_messages.create(message: "Alert!", starts_at: Date.today, ends_at: 15.days.from_now)
+      DOC
+      result <<~DOC
+        => #<BroadcastMessage id: 4, Active>
+        result.ends_at
+        => Thu, 09 Jan 2020 16:44:27 -0700
+      DOC
+    end
+
+    doc 'Create' do
+      title 'All options'
+
+      example <<~DOC
+        client.broadcast_messages.create(
+          message: "Scheduled Maintenance!",
+          starts_at: 2.days.from_now,
+          ends_at: 2.month.from_now,
+          color: "#ffffff",
+          font: "#34495E"
+        )
+      DOC
+      result <<~DOC
+        => #<BroadcastMessage id: 6, Inactive>
+      DOC
+    end
+
+    # Create
+    def create(query = {})
+      query[:starts_at] = query[:starts_at].to_time.iso8601 if format_time?(query[:starts_at])
+      query[:ends_at] = query[:ends_at].to_time.iso8601 if format_time?(query[:ends_at])
+
+      client.request(:post, 'broadcast_messages', BroadcastMessage, query)
+    end
+  end
+end

data/lib/labclient/broadcast_messages/delete.rb

@@ -0,0 +1,36 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class BroadcastMessages < Common
+    doc 'Delete' do
+      desc 'Delete a broadcast message.'
+      markdown 'You can delete broadcast messages via the `broadcast_messages` method or via the `BroadcastMessage` object'
+    end
+
+    doc 'Delete' do
+      desc 'Delete through broadcast_messages'
+      example <<~DOC
+        client.broadcast_messages.delete(5)
+      DOC
+    end
+
+    doc 'Delete' do
+      desc 'Delete through BroadcastMessage object'
+      example <<~DOC
+        broadcast.delete
+      DOC
+
+      result <<~DOC
+        broadcast = client.broadcast_messages.list.last
+        => #<BroadcastMessage id: 2, Active>
+        broadcast.delete
+        => nil
+      DOC
+    end
+
+    # Delete
+    def delete(broadcast_message_id = nil)
+      client.request(:delete, "broadcast_messages/#{broadcast_message_id}")
+    end
+  end
+end

data/lib/labclient/broadcast_messages/list.rb

@@ -0,0 +1,18 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class BroadcastMessages < Common
+    doc 'List' do
+      desc 'List all broadcast messages.'
+      example 'client.broadcast_messages.list'
+      result <<~DOC
+        => [#<BroadcastMessage id: 2, Active>, #<BroadcastMessage id: 1, Inactive>]
+      DOC
+    end
+
+    # List
+    def list
+      client.request(:get, 'broadcast_messages', BroadcastMessage)
+    end
+  end
+end

data/lib/labclient/broadcast_messages/show.rb

@@ -0,0 +1,18 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class BroadcastMessages < Common
+    doc 'Show' do
+      desc 'Get a specific broadcast message.'
+      example 'client.broadcast_messages.show(2)'
+      result <<~DOC
+        => #<BroadcastMessage id: 2, Inactive>
+      DOC
+    end
+
+    # Show Specific
+    def show(broadcast_message_id = nil)
+      client.request(:get, "broadcast_messages/#{broadcast_message_id}", BroadcastMessage)
+    end
+  end
+end

data/lib/labclient/broadcast_messages/update.rb

@@ -0,0 +1,75 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class BroadcastMessages < Common
+    doc 'Update' do
+      desc 'Update an existing broadcast message.'
+      markdown <<~DOC
+        | Attribute  | Type     | Required | Description                                           |
+        |------------| ---------|----------|-------------------------------------------------------|
+        | message    | string   | yes      | Message to display.                                   |
+        | starts_at  | datetime | no       | Starting time (defaults to current time).             |
+        | ends_at    | datetime | no       | Ending time (defaults to one hour from current time). |
+        | color      | string   | no       | Background color hex code.                            |
+        | font       | string   | no       | Foreground color hex code.                            |
+      DOC
+    end
+
+    doc 'Update' do
+      example <<~DOC
+        client.broadcast_messages.update(4, message: "Even more alert!")
+      DOC
+      result <<~DOC
+        => #<BroadcastMessage id: 4, Active>
+      DOC
+    end
+
+    doc 'Update' do
+      title 'Date Time Helpers'
+      markdown 'Both `:starts_at` and `:ends_at` can be used with Date or Time objects.   <small>_responds_to: `to_time`_</small>'
+
+      example <<~DOC
+        result = client.broadcast_messages.update(4, message: "Alert!", starts_at: Date.today, ends_at: 15.days.from_now)
+      DOC
+      result <<~DOC
+        => #<BroadcastMessage id: 4, Active>
+        result.ends_at
+        => Thu, 09 Jan 2020 16:44:27 -0700
+      DOC
+    end
+
+    doc 'Update' do
+      title 'Methods'
+      markdown 'You can update broadcast messages via the `broadcast_messages` method or via the `BroadcastMessage` object'
+    end
+
+    doc 'Update' do
+      desc 'Update through broadcast_messages'
+      example <<~DOC
+        client.broadcast_messages.update(5, message: 'Update here!')
+      DOC
+    end
+
+    doc 'Update' do
+      desc 'Update through BroadcastMessage object'
+      example <<~DOC
+        broadcast.update(message: 'Another here!')
+      DOC
+
+      result <<~DOC
+        broadcast = client.broadcast_messages.list.last
+        => #<BroadcastMessage id: 2, Active>
+        broadcast.update(message: 'Another here!')
+        => #<BroadcastMessage id: 2, Active>
+      DOC
+    end
+
+    # Update
+    def update(broadcast_message_id = nil, query = {})
+      query[:starts_at] = query[:starts_at].to_time.iso8601 if format_time?(query[:starts_at])
+      query[:ends_at] = query[:ends_at].to_time.iso8601 if format_time?(query[:ends_at])
+
+      client.request(:put, "broadcast_messages/#{broadcast_message_id}", BroadcastMessage, query)
+    end
+  end
+end

data/lib/labclient/ci_lint/ci_lint.rb

@@ -0,0 +1,43 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class CiLint < Common
+    doc 'Lint' do
+      desc 'Checks if your .gitlab-ci.yml file is valid.'
+      example <<~DOC
+        client.ci_lint.check <<~YAML
+          image: busybox:latest
+
+          build:
+            script:
+              - echo "Do your build here"
+
+        YAML
+      DOC
+      result <<~DOC
+        =>  {:status=>"valid", :errors=>[]}
+      DOC
+    end
+
+    doc 'Lint' do
+      desc 'Invalid Output'
+      example <<~DOC
+        client.ci_lint.check("baddddd")
+      DOC
+      result <<~DOC
+        => {:status=>"invalid", :errors=>["Invalid configuration format"]}
+      DOC
+    end
+
+    doc 'Lint' do
+      desc 'Read from File'
+      example <<~DOC
+        client.ci_lint.check File.read('.gitlab-ci.yml')
+      DOC
+    end
+
+    def check(content)
+      client.request(:post, 'ci/lint', nil, content: content)
+    end
+  end
+end

data/lib/labclient/class_helpers.rb

@@ -0,0 +1,17 @@
+# Top Namesapce
+module LabClient
+  # Shared Methods
+  module ClassHelpers
+    def keys
+      to_h.keys.sort
+    end
+
+    def has?(key)
+      @table.key?(key) && !@table[key].blank?
+    end
+
+    def raw
+      to_h
+    end
+  end
+end