labclient 0.1.0

data/lib/labclient/pipelines/pipeline.rb

@@ -0,0 +1,48 @@
+# Top namespace
+module LabClient
+  # Inspect Helper
+  class Pipeline < Klass
+    include ClassHelpers
+
+    def inspect
+      "#<Pipeline id: #{id}, ref: #{ref}, status: #{status}>"
+    end
+
+    def variables
+      project_id = collect_project_id
+      client.pipelines.variables(project_id, id)
+    end
+
+    def retry
+      project_id = collect_project_id
+      client.pipelines.retry(project_id, id)
+    end
+
+    def cancel
+      project_id = collect_project_id
+      update_self client.pipelines.cancel(project_id, id)
+    end
+
+    def delete
+      project_id = collect_project_id
+      client.pipelines.delete(project_id, id)
+    end
+
+    def jobs(scope = nil)
+      project_id = collect_project_id
+      client.jobs.pipeline(project_id, id, scope)
+    end
+
+    # DateTime Fields
+    date_time_attrs %i[created_at updated_at finished_at started_at]
+    user_attrs %i[user]
+
+    help do
+      subtitle 'Pipeline'
+      option 'variables', 'Show variables from this pipeline'
+      option 'retry', 'Retry jobs in this pipeline'
+      option 'cancel', 'Cancel jobs in this pipeline'
+      option 'delete', 'Delete this pipeline'
+    end
+  end
+end

data/lib/labclient/pipelines/retry.rb

@@ -0,0 +1,34 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class Pipelines < Common
+    doc 'Retry' do
+      desc 'Retry jobs in a pipeline. [Project ID, Pipeline ID]'
+      example 'client.pipelines.retry(264, 7)'
+      result '#<Pipeline id: 7, ref: master, status: running>'
+    end
+
+    doc 'Retry' do
+      desc 'Via Project'
+      example <<~DOC
+        project = client.projects.show(5)
+        project.pipeline_retry(7)
+      DOC
+    end
+
+    doc 'Retry' do
+      desc 'Via Pipeline'
+      example <<~DOC
+        pipeline = client.pipelines.show(264,7)
+        pipeline.retry
+      DOC
+    end
+
+    def retry(project_id, pipeline_id)
+      project_id = format_id(project_id)
+      pipeline_id = format_id(pipeline_id)
+
+      client.request(:post, "projects/#{project_id}/pipelines/#{pipeline_id}/retry", Pipeline)
+    end
+  end
+end

data/lib/labclient/pipelines/show.rb

@@ -0,0 +1,26 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class Pipelines < Common
+    doc 'Show' do
+      desc 'Get a single pipeline. [Project ID, Pipeline ID]'
+      example 'client.pipelines.show(264,6)'
+      result '#<Pipeline id: 6, ref: master, status: success>'
+    end
+
+    doc 'Show' do
+      desc 'Via Project'
+      example <<~DOC
+        project = client.projects.show(5)
+        project.pipeline(6)
+      DOC
+    end
+
+    def show(project_id, pipeline_id)
+      project_id = format_id(project_id)
+      pipeline_id = format_id(pipeline_id)
+
+      client.request(:get, "projects/#{project_id}/pipelines/#{pipeline_id}", Pipeline)
+    end
+  end
+end

data/lib/labclient/pipelines/variables.rb

@@ -0,0 +1,47 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class Pipelines < Common
+    doc 'Show' do
+      title 'Variables'
+      desc 'Get variables of a pipeline. [Project ID, Pipeline ID]'
+      example 'client.pipelines.variables(264,1)'
+      result <<~DOC
+        [
+          {
+            "key": "RUN_NIGHTLY_BUILD",
+            "variable_type": "env_var",
+            "value": "true"
+          },
+          {
+            "key": "foo",
+            "value": "bar"
+          }
+        ]
+      DOC
+    end
+
+    doc 'Show' do
+      desc 'Via Project'
+      example <<~DOC
+        project = client.projects.show(264)
+        project.pipeline_variables(7)
+      DOC
+    end
+
+    doc 'Show' do
+      desc 'Via Pipeline'
+      example <<~DOC
+        pipeline = client.pipelines.show(264,7)
+        pipeline.variables
+      DOC
+    end
+
+    def variables(project_id, pipeline_id)
+      project_id = format_id(project_id)
+      pipeline_id = format_id(pipeline_id)
+
+      client.request(:get, "projects/#{project_id}/pipelines/#{pipeline_id}/variables")
+    end
+  end
+end

data/lib/labclient/projects/access_requests/access_request.rb

@@ -0,0 +1,34 @@
+# Top namespace
+module LabClient
+  # Inspect Helper
+  class ProjectAccessRequest < Klass
+    include ClassHelpers
+    def inspect
+      "#<ProjectAccessRequest id: #{id}, name: #{name}, state: #{state}>"
+    end
+
+    def user
+      client.users.show(id)
+    end
+
+    def approve(access_level = :developer)
+      project_id = collect_project_id
+      client.projects.access_requests.approve(project_id, id, access_level)
+    end
+
+    def deny
+      project_id = collect_project_id
+      client.projects.access_requests.deny(project_id, id)
+    end
+
+    date_time_attrs %i[created_at]
+
+    help do
+      @group_name = 'Projects'
+      subtitle 'ProjectAccessRequest'
+      option 'user', 'Show user for access request'
+      option 'approve', 'Accept access request [Access Level]'
+      option 'deny', 'Deny request'
+    end
+  end
+end

data/lib/labclient/projects/access_requests/approve.rb

@@ -0,0 +1,38 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class ProjectAccessRequests < Common
+    doc 'Approve' do
+      desc 'Approves an access request for the given user. [Project ID, User ID, Access Level]'
+      example 'client.projects.access_requests.approve(310, 3)'
+
+      result '=>  #<ProjectAccessRequest id: 3, name: planet bob>'
+    end
+
+    doc 'Approve' do
+      markdown <<~DOC
+        | Attribute    | Type    | Description                                                 |
+        | ----------             | ---------                                                   |
+        | access_level | integer | A valid access level (defaults: 30, developer access level) |
+      DOC
+    end
+
+    doc 'Approve' do
+      desc 'Via ProjectAccessRequest [Access Level]'
+      example <<~DOC
+        request = client.projects.access_requests(16).first
+        request.approve(:developer)
+      DOC
+    end
+
+    def approve(project_id, user_id, access_level = :developer)
+      project_id = format_id(project_id)
+      user_id = format_id(user_id)
+
+      query = { access_level: access_level }
+      query_access_level(query, :access_level)
+
+      client.request(:put, "projects/#{project_id}/access_requests/#{user_id}/approve", ProjectAccessRequest, query)
+    end
+  end
+end

data/lib/labclient/projects/access_requests/client.rb

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

data/lib/labclient/projects/access_requests/create.rb

@@ -0,0 +1,25 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class ProjectAccessRequests < Common
+    doc 'Create' do
+      desc 'Requests access for the authenticated user to a or project.'
+      example <<~DOC
+        client.projects.access_requests.create(310)
+      DOC
+    end
+
+    doc 'Create' do
+      desc 'Via Project'
+      example <<~DOC
+        project = client.projects.show(100)
+        project.request_access
+      DOC
+    end
+
+    def create(project_id)
+      project_id = format_id(project_id)
+      client.request(:post, "projects/#{project_id}/access_requests", ProjectAccessRequest)
+    end
+  end
+end

data/lib/labclient/projects/access_requests/deny.rb

@@ -0,0 +1,25 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class ProjectAccessRequests < Common
+    doc 'Deny' do
+      desc 'Deny an access request for the given user. [Project ID, User ID]'
+      example 'client.projects.access_requests.deny(310, 3)'
+    end
+
+    doc 'Deny' do
+      desc 'Via ProjectAccessRequest [Access Level]'
+      example <<~DOC
+        request = client.projects.access_requests(16).first
+        request.deny
+      DOC
+    end
+
+    def deny(project_id, user_id)
+      project_id = format_id(project_id)
+      user_id = format_id(user_id)
+
+      client.request(:delete, "projects/#{project_id}/access_requests/#{user_id}/deny")
+    end
+  end
+end

data/lib/labclient/projects/access_requests/list.rb

@@ -0,0 +1,24 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class ProjectAccessRequests < Common
+    doc 'List' do
+      desc 'Gets a list of access requests viewable by the authenticated user. [Project ID]'
+      example 'client.projects.access_requests.list(16)'
+    end
+
+    doc 'List' do
+      desc 'Via Project'
+      example <<~DOC
+        project = client.projects.show(16)
+        project.access_requests
+      DOC
+    end
+
+    def list(project_id)
+      project_id = format_id(project_id)
+
+      client.request(:get, "projects/#{project_id}/access_requests", ProjectAccessRequest)
+    end
+  end
+end

data/lib/labclient/projects/archive.rb

@@ -0,0 +1,25 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class Projects < Common
+    doc 'Update' do
+      title 'Archive'
+      example 'client.projects.archive(25)'
+      result '#<Project id: 25 badlands/chaurushunter>'
+    end
+
+    doc 'Update' do
+      desc 'Via Project'
+      example <<~DOC
+        project = client.projects.show(299)
+        project.archive
+      DOC
+    end
+
+    def archive(project_id)
+      project_id = format_id(project_id)
+
+      client.request(:post, "projects/#{project_id}/archive", Project)
+    end
+  end
+end

data/lib/labclient/projects/badges/client.rb

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

data/lib/labclient/projects/badges/create.rb

@@ -0,0 +1,49 @@
+# rubocop:disable Style/FormatStringToken
+# Top namespace
+module LabClient
+  # Specifics
+  class ProjectBadges < Common
+    doc 'Create' do
+      desc 'Adds a badge to a group. [Project ID, Hash]'
+      example <<~DOC
+        client.projects.badges.create(
+          100,
+          name: 'rawr',
+          link_url:'https://example.gitlab.com/%{project_path}',
+          image_url:'https://example.gitlab.com/%{project_path}/badges/%{default_branch}/pipeline.svg'
+        )
+      DOC
+
+      result '=>  #<ProjectBadge id: 2, url: http://labclient.com>'
+    end
+
+    doc 'Create' do
+      markdown <<~DOC
+        | Attribute | Type | Required | Description |
+        | --------- | ---- | -------- | ----------- |
+        | name | string | no | Name for Badge |
+        | link_url | string | yes | URL of the badge link |
+        | image_url | string | yes | URL of the badge image |
+      DOC
+    end
+
+    doc 'Create' do
+      desc 'Via Project'
+      example <<~DOC
+        project = client.projects.show(100)
+        badge = project.badge_create(
+          name: 'rawr',
+          link_url:'https://example.gitlab.com/%{project_path}',
+          image_url:'https://example.gitlab.com/%{project_path}/badges/%{default_branch}/pipeline.svg'
+        )
+      DOC
+    end
+
+    def create(project_id, query)
+      project_id = format_id(project_id)
+
+      client.request(:post, "projects/#{project_id}/badges", ProjectBadge, query)
+    end
+  end
+end
+# rubocop:enable Style/FormatStringToken

data/lib/labclient/projects/badges/delete.rb

@@ -0,0 +1,33 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class ProjectBadges < Common
+    doc 'Delete' do
+      desc 'Removes a badge from a project. [Project ID, Badge ID]'
+      example 'client.projects.badges.delete(16, 1)'
+    end
+
+    doc 'Delete' do
+      desc 'Via Project [Badge ID]'
+      example <<~DOC
+        project = client.projects.show(100)
+        project.badge_delete(3)
+      DOC
+    end
+
+    doc 'Delete' do
+      desc 'Via ProjectBadge'
+      example <<~DOC
+        badge = client.projects.badges.show(100, 4)
+        badge.delete
+      DOC
+    end
+
+    def delete(project_id, badge_id)
+      project_id = format_id(project_id)
+      badge_id = format_id(badge_id)
+
+      client.request(:delete, "projects/#{project_id}/badges/#{badge_id}")
+    end
+  end
+end

data/lib/labclient/projects/badges/list.rb

@@ -0,0 +1,28 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class ProjectBadges < Common
+    doc 'List' do
+      desc 'Gets a list of a project badges. [Project ID]'
+      example 'client.projects.badges.list(16)'
+
+      result <<~DOC
+        => [#<ProjectBadge id: 2, name: first >, #<ProjectBadge id: 3, name: rawr>]
+      DOC
+    end
+
+    doc 'List' do
+      desc 'Via Project'
+      example <<~DOC
+        project = client.projects.show(16)
+        project.badges
+      DOC
+    end
+
+    def list(project_id)
+      project_id = format_id(project_id)
+
+      client.request(:get, "projects/#{project_id}/badges", ProjectBadge)
+    end
+  end
+end

data/lib/labclient/projects/badges/preview.rb

@@ -0,0 +1,42 @@
+# rubocop:disable Style/FormatStringToken
+# Top namespace
+module LabClient
+  # Specifics
+  class ProjectBadges < Common
+    doc 'Preview' do
+      desc 'Returns how the link_url and image_url final URLs would be after resolving the placeholder interpolation. [Project ID, Badge ID]'
+      example <<~DOC
+        client.projects.badges.preview(
+          100,
+          link_url:'https://example.gitlab.com/%{project_path}',
+          image_url:'https://example.gitlab.com/%{project_path}/badges/%{default_branch}/pipeline.svg'
+        )
+      DOC
+    end
+
+    doc 'Preview' do
+      markdown <<~DOC
+        | Attribute | Type | Required | Description |
+        | --------- | ---- | -------- | ----------- |
+        | name | string | no | Name for Badge |
+        | link_url | string | yes | URL of the badge link |
+        | image_url | string | yes | URL of the badge image |
+      DOC
+    end
+
+    doc 'Preview' do
+      desc 'Via ProjectBadge'
+      example <<~DOC
+        badge = client.projects.badges.show(100, 4)
+        badge.preview
+      DOC
+    end
+
+    def preview(project_id, query)
+      project_id = format_id(project_id)
+
+      client.request(:get, "projects/#{project_id}/badges/render", nil, query)
+    end
+  end
+end
+# rubocop:enable Style/FormatStringToken

data/lib/labclient/projects/badges/project_badge.rb

@@ -0,0 +1,47 @@
+# Top namespace
+module LabClient
+  # Inspect Helper
+  class ProjectBadge < Klass
+    include ClassHelpers
+    def inspect
+      "#<ProjectBadge id: #{id}, name: #{name}>"
+    end
+
+    def project
+      project_id = collect_project_id
+      client.projects.show project_id
+    end
+
+    def update(query)
+      project_id = collect_project_id
+
+      update_self client.projects.badges.update(project_id, id, query)
+    end
+
+    def delete
+      project_id = collect_project_id
+
+      client.projects.badges.delete(project_id, id)
+    end
+
+    def preview
+      project_id = collect_project_id
+
+      client.projects.badges.preview(project_id, {
+                                       link_url: link_url,
+                                       image_url: image_url
+                                     })
+    end
+
+    date_time_attrs %i[created_at]
+
+    help do
+      @group_name = 'Projects'
+      subtitle 'ProjectBadge'
+      option 'project', 'Show Project'
+      option 'update', 'Update this badge [Hash]'
+      option 'delete', 'Delete this badge'
+      option 'preview', 'Show render of interpolation'
+    end
+  end
+end

data/lib/labclient/projects/badges/show.rb

@@ -0,0 +1,27 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class ProjectBadges < Common
+    doc 'Show' do
+      desc 'Gets a badge of a project. [Project ID, Badge ID]'
+      example 'client.projects.badges.show(100, 1)'
+
+      result '=>  #<ProjectBadge id: 1, name: first>'
+    end
+
+    doc 'Show' do
+      desc 'Via Project [Badge ID]'
+      example <<~DOC
+        project = client.projects.show(16)
+        badge = project.badge_show(1)
+      DOC
+    end
+
+    def show(project_id, badge_id)
+      project_id = format_id(project_id)
+      badge_id = format_id(badge_id)
+
+      client.request(:get, "projects/#{project_id}/badges/#{badge_id}", ProjectBadge)
+    end
+  end
+end

data/lib/labclient/projects/badges/update.rb

@@ -0,0 +1,45 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class ProjectBadges < Common
+    doc 'Update' do
+      desc 'Updates a badge of a group. [Project ID, Badge ID, Params]'
+      example 'client.projects.badges.update(100, 3, name: "planet bob")'
+
+      result '=>  #<ProjectBadge id: 3, name: planet bob>'
+    end
+
+    doc 'Update' do
+      markdown <<~DOC
+        | Attribute | Type | Required | Description |
+        | --------- | ---- | -------- | ----------- |
+        | name | string | no | Name for Badge |
+        | link_url | string | no | URL of the badge link |
+        | image_url | string | no | URL of the badge image |
+      DOC
+    end
+
+    doc 'Update' do
+      desc 'Via Project [Badge ID, Params]'
+      example <<~DOC
+        project = client.projects.show(16)
+        badge = project.badge_update(4, name: "another")
+      DOC
+    end
+
+    doc 'Update' do
+      desc 'Via ProjectBadge [Params]'
+      example <<~DOC
+        badge = client.projects.badges.show(100, 4)
+        badge.update(name: "switchy")
+      DOC
+    end
+
+    def update(project_id, badge_id, query)
+      project_id = format_id(project_id)
+      badge_id = format_id(badge_id)
+
+      client.request(:put, "projects/#{project_id}/badges/#{badge_id}", ProjectBadge, query)
+    end
+  end
+end