labclient 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 79977702325d9d9a7df2569a8e1e948db351fc35deea828a832a548048efa7b3
-  data.tar.gz: 1febe4b7a2eab857c37fc814b299678a35c86be61c8d346806c5d8092ea154af
+  metadata.gz: 0cfc44546096a710f5e2a8ed0b500b202825150b03a029738d8b870cf4258e94
+  data.tar.gz: c965712946b26eef38ae7546a483688eae0ae20cc82480dad59262aa050ba18c
 SHA512:
-  metadata.gz: 14eabf457805cece5387012fcd28ae9922ce554a6981aa21653d98404b274e6438b49686e0b6a7f8f3dbd14f16520089c58141ff08f2310c5314b52d31facc6c
-  data.tar.gz: 93b298936e970390a1886e03ddb4473d57df7adcfe75be983770fe09d5674cd5544776abd239c02c11a9ab93445aeee10c77fcb7cd2236e884174d844eec4e9b
+  metadata.gz: 77a79ac90bfa375a488633c9aa530581a8235c3b5c0d00fd24644ccb962fd39152facc298e77a016cffb200f65b301e6d2c7a1ed883f2dfd2ea0dc6d96ea185d
+  data.tar.gz: cc4cb427458a49007775e063fc065df0623c76f4abe05f0b93279e3ca1638b9b0c024074cb8ac57e7ab732543c39da7cb9f436f2ca85263995c72bbf083d1df9

data/lib/labclient.rb

@@ -49,45 +49,6 @@ require 'labclient/users/delete'
 require 'labclient/users/delete_identity'
 require 'labclient/users/user'
 
-# User Keys
-require 'labclient/users/keys/client'
-require 'labclient/users/keys/list'
-require 'labclient/users/keys/show'
-require 'labclient/users/keys/create'
-require 'labclient/users/keys/delete'
-
-# Notifications
-require 'labclient/notifications/list'
-require 'labclient/notifications/update'
-
-# User GPG Keys
-require 'labclient/users/gpg/client'
-require 'labclient/users/gpg/list'
-require 'labclient/users/gpg/show'
-require 'labclient/users/gpg/create'
-require 'labclient/users/gpg/delete'
-require 'labclient/users/gpg/gpg_key'
-
-# User Emails
-require 'labclient/users/email/client'
-require 'labclient/users/email/list'
-require 'labclient/users/email/show'
-require 'labclient/users/email/create'
-require 'labclient/users/email/delete'
-require 'labclient/users/email/email'
-
-# Impersonation Tokens
-require 'labclient/impersonation_tokens/impersonation_token'
-require 'labclient/impersonation_tokens/list'
-require 'labclient/impersonation_tokens/show'
-require 'labclient/impersonation_tokens/create'
-require 'labclient/impersonation_tokens/revoke'
-
-# Namespaces
-require 'labclient/namespaces/namespace'
-require 'labclient/namespaces/list'
-require 'labclient/namespaces/show'
-
 # ===============================================
 # Projects
 # ===============================================
@@ -116,6 +77,9 @@ require 'labclient/projects/restore'
 require 'labclient/projects/snapshot'
 require 'labclient/projects/github_import'
 
+# Group Stub / Docs ORder
+require 'labclient/groups/stub'
+
 # Project Forks
 require 'labclient/projects/forks/list'
 require 'labclient/projects/forks/fork'
@@ -684,6 +648,45 @@ require 'labclient/notes/epics/delete'
 require 'labclient/notes/note'
 # -----------------------------------
 
+# User Keys
+require 'labclient/users/keys/client'
+require 'labclient/users/keys/list'
+require 'labclient/users/keys/show'
+require 'labclient/users/keys/create'
+require 'labclient/users/keys/delete'
+
+# Notifications
+require 'labclient/notifications/list'
+require 'labclient/notifications/update'
+
+# User GPG Keys
+require 'labclient/users/gpg/client'
+require 'labclient/users/gpg/list'
+require 'labclient/users/gpg/show'
+require 'labclient/users/gpg/create'
+require 'labclient/users/gpg/delete'
+require 'labclient/users/gpg/gpg_key'
+
+# User Emails
+require 'labclient/users/email/client'
+require 'labclient/users/email/list'
+require 'labclient/users/email/show'
+require 'labclient/users/email/create'
+require 'labclient/users/email/delete'
+require 'labclient/users/email/email'
+
+# Impersonation Tokens
+require 'labclient/impersonation_tokens/impersonation_token'
+require 'labclient/impersonation_tokens/list'
+require 'labclient/impersonation_tokens/show'
+require 'labclient/impersonation_tokens/create'
+require 'labclient/impersonation_tokens/revoke'
+
+# Namespaces
+require 'labclient/namespaces/namespace'
+require 'labclient/namespaces/list'
+require 'labclient/namespaces/show'
+
 # Runners
 require 'labclient/runners/list'
 require 'labclient/runners/all'

data/lib/labclient/common.rb

@@ -72,6 +72,11 @@ module LabClient
       CGI.escape obj_id.to_s
     end
 
+    def format_query_id(key, query)
+      query[key] = format_id(query[key]) if query.key? key
+      query[key.to_s] = format_id(query[key.to_s]) if query.key? key.to_s
+    end
+
     def format_query_ids(key, query)
       query[key] = query[key].map { |x| format_id(x) } if query.key? key
 

data/lib/labclient/groups/group.rb

@@ -49,10 +49,17 @@ module LabClient
       end
     end
 
+    def project_create(query)
+      query[:namespace_id] = id
+      client.projects.create(query)
+    end
+
     def ldap_list
       client.groups.ldap.list(id)
     end
 
+    alias ldap_links ldap_list
+
     def ldap_sync
       client.groups.ldap.sync(id)
     end
@@ -247,12 +254,14 @@ module LabClient
       option 'audit_events', "List this group's AuditEvents"
       option 'audit_event', 'Show a specific AuditEvents [Audit Event ID]'
       option 'projects', 'List direct Projects [Hash]'
+      option 'project_create', 'Create a project in this Group [Hash]'
       option 'details', 'Get all details [Hash]'
       option 'search', 'Search by scope within group [scope, search_string]'
       option 'delete', 'Delete this Group'
       option 'restore', 'Restore if marked for deletion'
       option 'transfer', 'Transfer project to this group [Project ID]'
       option 'ldap_list', 'Lists LDAP group links'
+      option 'ldap_links', 'Alias for ldap_list'
       option 'ldap_sync', 'Syncs the group with its linked LDAP group'
       option 'ldap_create', 'Adds an LDAP group link. [Hash]'
       option 'ldap_delete', 'Deletes an LDAP group link. [CN, Provider(optional)]'

data/lib/labclient/groups/stub.rb

@@ -0,0 +1,8 @@
+# Top namespace
+module LabClient
+  # Ugly Hack, but Makes Docs Easy
+  class Groups < Common
+    doc '' do
+    end
+  end
+end

data/lib/labclient/http.rb

@@ -80,7 +80,11 @@ module Typhoeus
     end
 
     def friendly_error
-      message = data[:message] || data[:error] || data
+      message = if data
+                  data[:message] || data[:error] || data
+                else
+                  return_message
+                end
       "#{code} - #{message}"
     end
   end

data/lib/labclient/issues/agent_detail.rb

@@ -4,7 +4,7 @@ module LabClient
   class Issues < Common
     doc 'Show' do
       title 'Agent Detail'
-      desc 'Get user agent details [project id, issue iid]'
+      desc 'Get user agent details [Project ID, Issue IID]'
       example 'client.issues.agent_detail(30, 1)'
       result <<~DOC
         => {:user_agent=>"Mozilla/5.0 (X11; Linux x86_64; rv:72.0) Gecko/20100101 Firefox/72.0", :ip_address=>"10.0.0.14", :akismet_submitted=>false}

data/lib/labclient/issues/closed_by.rb

@@ -4,7 +4,7 @@ module LabClient
   class Issues < Common
     doc 'Show' do
       subtitle 'Closed By'
-      desc 'Get all the merge requests that will close issue when merged. [project id, issue iid]'
+      desc 'Get all the merge requests that will close issue when merged. [Project ID, Issue IID]'
       example 'client.issues.closed_by(5, 1)'
       result <<~DOC
         => [#<MergeRequest id: 5, title: Update README.md, state: opened>]

data/lib/labclient/issues/create.rb

@@ -3,7 +3,7 @@ module LabClient
   # Specifics
   class Issues < Common
     doc 'Create' do
-      desc 'Creates a new project issue. [project id]'
+      desc 'Creates a new project issue. [Project ID]'
       example 'client.issues.create(5, title: "Fancy!")'
       result <<~DOC
         => #<Issue id: 1, title: Fancy!, state: opened>
@@ -14,10 +14,20 @@ module LabClient
       markdown <<~DOC
         See [API docs here](https://docs.gitlab.com/ee/api/issues.html#new-issue) for full list of attributes
 
-        | Attribute                                 | Type           | Required | Description  |
-        |-------------------------------------------|----------------|----------|--------------|
-        | title                                   | string         | yes      | The title of an issue |
-        | description                             | string         | no       | The description of an issue. Limited to 1,048,576 characters. |
+        | Attribute   | Type           | Required | Description  |
+        |-------------|----------------|----------|--------------|
+        | title       | string         | yes      | The title of an issue |
+        | description | string         | no       | The description of an issue. Limited to 1,048,576 characters. |
+
+        &nbsp;
+      DOC
+    end
+
+    doc 'Create' do
+      desc 'Via Project [Hash]'
+      example <<~DOC
+        project = client.projects.show(16)
+        project.issue_create(title: "Fancy!")
       DOC
     end
 

data/lib/labclient/issues/delete.rb

@@ -3,7 +3,7 @@ module LabClient
   # Specifics
   class Issues < Common
     doc 'Delete' do
-      desc 'Updates an existing project issue. This call is also used to mark an issue as closed. [project id, issue iid]'
+      desc 'Updates an existing project issue. This call is also used to mark an issue as closed. [Project ID, Issue IID]'
       example 'client.issues.delete(5, 1)'
       result <<~DOC
         => #<Issue id: 1, title: Moar Fancy!, state: opened>

data/lib/labclient/issues/move.rb

@@ -3,7 +3,7 @@ module LabClient
   # Specifics
   class Issues < Common
     doc 'Move' do
-      desc 'Moves an issue to a different project. [project id, issue iid, target project id]'
+      desc 'Moves an issue to a different project. [Project ID, issue iid, target project id]'
       example 'client.issues.move(5, 1, 6)'
       result <<~DOC
         => #<Issue id: 1, title: Moar Fancy!, state: opened>

data/lib/labclient/issues/participants.rb

@@ -4,7 +4,7 @@ module LabClient
   class Issues < Common
     doc 'Show' do
       title 'Participants'
-      desc 'Get a list of issue participants. [project id, issue iid]'
+      desc 'Get a list of issue participants. [Project ID, Issue IID]'
       example 'client.issues.participants(30,1)'
       result <<~DOC
         => [#<User id: 1, username: braum>, #<User id: 52, username: anivia>]

data/lib/labclient/issues/related_merge_requests.rb

@@ -5,7 +5,7 @@ module LabClient
     doc 'Show' do
       title 'Merge Requests'
       subtitle 'Related'
-      desc 'Get all the merge requests that are related to the issue. [project id, issue iid]'
+      desc 'Get all the merge requests that are related to the issue. [Project ID, Issue IID]'
       example 'client.issues.related_merge_requests(5, 1)'
       result <<~DOC
         => [#<MergeRequest id: 5, title: Update README.md, state: opened>]

data/lib/labclient/issues/show.rb

@@ -3,7 +3,7 @@ module LabClient
   # Specifics
   class Issues < Common
     doc 'Show' do
-      desc 'Get a single project issue. [project, issue iid]'
+      desc 'Get a single project issue. [project, Issue IID]'
       example 'client.issues.show(343, 1)'
       result <<~DOC
         => #<Issue id: 1, title: Front-line global approach, state: opened>

data/lib/labclient/issues/subscribe.rb

@@ -4,7 +4,7 @@ module LabClient
   class Issues < Common
     doc 'Update' do
       title 'Subscribe'
-      desc 'Subscribes the authenticated user to an issue to receive notifications. [project id, issue iid]'
+      desc 'Subscribes the authenticated user to an issue to receive notifications. [Project ID, Issue IID]'
 
       example 'client.issues.subscribe(343, 7)'
 

data/lib/labclient/issues/time_stats.rb

@@ -4,7 +4,7 @@ module LabClient
   class Issues < Common
     doc 'Time Stats' do
       title 'Show'
-      desc 'Get time tracking stats. [project id, issue iid]'
+      desc 'Get time tracking stats. [Project ID, Issue IID]'
       example 'client.issues.time_stats(30, 1)'
       result <<~DOC
         => {:time_estimate=>0, :total_time_spent=>0, :human_time_estimate=>nil, :human_total_time_spent=>nil}
@@ -28,7 +28,7 @@ module LabClient
 
     doc 'Time Stats' do
       title 'Add'
-      desc 'Adds spent time for this merge request. [project id, issue iid, duration]'
+      desc 'Adds spent time for this merge request. [Project ID, issue iid, duration]'
       markdown 'Duration accepts Human Format, or ActiveSupport::Duration (e.g. 1.hour)'
     end
 
@@ -67,7 +67,7 @@ module LabClient
 
     doc 'Time Stats' do
       title 'Estimate'
-      desc 'Sets an estimated time of work for this merge request. [project id, issue iid, duration]'
+      desc 'Sets an estimated time of work for this merge request. [Project ID, issue iid, duration]'
       markdown 'Duration accepts Human Format, or ActiveSupport::Duration (e.g. 1.hour)'
     end
 
@@ -108,7 +108,7 @@ module LabClient
     doc 'Time Stats' do
       title 'Reset'
       subtitle 'Estimate'
-      desc 'Resets the estimated time for this merge request to 0 seconds. [project id, issue iid]'
+      desc 'Resets the estimated time for this merge request to 0 seconds. [Project ID, Issue IID]'
       example 'client.issues.reset_time_estimate(30, 1)'
       result <<~DOC
         => {:time_estimate=>0, :total_time_spent=>0, :human_time_estimate=>nil, :human_total_time_spent=>nil}
@@ -132,7 +132,7 @@ module LabClient
 
     doc 'Time Stats' do
       subtitle 'Time Spent'
-      desc 'Resets the estimated time for this merge request to 0 seconds. [project id, issue iid]'
+      desc 'Resets the estimated time for this merge request to 0 seconds. [Project ID, Issue IID]'
       example 'client.issues.reset_spent_time(30, 1)'
       result <<~DOC
         => {:time_estimate=>0, :total_time_spent=>0, :human_time_estimate=>nil, :human_total_time_spent=>nil}

data/lib/labclient/issues/todo.rb

@@ -4,7 +4,7 @@ module LabClient
   class Issues < Common
     doc 'Update' do
       title 'Todo'
-      desc 'Manually creates a todo for the current user on an issue. [project id, merge request iid]'
+      desc 'Manually creates a todo for the current user on an issue. [Project ID, merge request iid]'
 
       example 'client.issues.todo(30, 1)'
 

data/lib/labclient/issues/unsubscribe.rb

@@ -4,7 +4,7 @@ module LabClient
   class Issues < Common
     doc 'Update' do
       title 'Unsubscribe'
-      desc 'Unsubscribes the authenticated user from the issue to not receive notifications from it. [project id, issue iid]'
+      desc 'Unsubscribes the authenticated user from the issue to not receive notifications from it. [Project ID, Issue IID]'
 
       example 'client.issues.unsubscribe(343, 7)'
 

data/lib/labclient/issues/update.rb

@@ -3,7 +3,7 @@ module LabClient
   # Specifics
   class Issues < Common
     doc 'Update' do
-      desc 'Updates an existing project issue. This call is also used to mark an issue as closed. [project id, issue iid]'
+      desc 'Updates an existing project issue. This call is also used to mark an issue as closed. [Project ID, Issue IID]'
       example 'client.issues.update(5, 1, title: "Moar Fancy!")'
       result <<~DOC
         => #<Issue id: 1, title: Moar Fancy!, state: opened>

data/lib/labclient/klass.rb

@@ -34,6 +34,10 @@ module LabClient
       nil
     end
 
+    def valid_group_project_levels
+      %i[guest reporter developer maintainer owner]
+    end
+
     # TODO: Combine all of these?
     def collect_project_id(position = 1)
       response.path.split('/')[position]

data/lib/labclient/merge_requests/accept.rb

@@ -4,7 +4,7 @@ module LabClient
   class MergeRequests < Common
     doc 'Update' do
       title 'Accept'
-      desc 'Merge changes submitted with MR. [project id, merge request iid]'
+      desc 'Merge changes submitted with MR. [Project ID, merge request iid]'
 
       markdown <<~DOC
         - <small>if merge request is unable to be accepted (ie: Work in Progress, Closed, Pipeline Pending Completion, or Failed while requiring Success) - you'll get a `405` and the error message 'Method Not Allowed'</small>

data/lib/labclient/merge_requests/cancel_auto_merge.rb

@@ -4,7 +4,7 @@ module LabClient
   class MergeRequests < Common
     doc 'Update' do
       title 'Cancel Auto Merge'
-      desc 'Cancel Automatic Merge When Pipeline Succeeds [project id, merge request iid]'
+      desc 'Cancel Automatic Merge When Pipeline Succeeds [Project ID, merge request iid]'
       markdown <<~DOC
         - If you don't have permissions to accept this merge request - you'll get a `401`
 

data/lib/labclient/merge_requests/changes.rb

@@ -4,7 +4,7 @@ module LabClient
   class MergeRequests < Common
     doc 'Show' do
       title 'Changes'
-      desc 'Shows information about the merge request including its files and changes. [project id, mr iid]'
+      desc 'Shows information about the merge request including its files and changes. [Project ID, mr iid]'
       example 'client.merge_requests.changes(333,1)'
       result <<~DOC
         => #<Changes MR: 1, title: Update README.md>

data/lib/labclient/merge_requests/closes_issues.rb

@@ -4,7 +4,7 @@ module LabClient
   class MergeRequests < Common
     doc 'Show' do
       title 'Closes Issues'
-      desc 'Get all the issues that would be closed by merging the provided merge request. [project id, mr iid]'
+      desc 'Get all the issues that would be closed by merging the provided merge request. [Project ID, mr iid]'
       example 'client.merge_requests.closes_issues(343, 1)'
       result <<~DOC
         => => [#<Issue id: 1, title: Problem!, state: opened>]

data/lib/labclient/merge_requests/commits.rb

@@ -4,7 +4,7 @@ module LabClient
   class MergeRequests < Common
     doc 'Show' do
       title 'Commits'
-      desc 'Get a list of merge request commits. [project id, mr iid]'
+      desc 'Get a list of merge request commits. [Project ID, mr iid]'
       example 'client.merge_requests.commits(333,1)'
       result <<~DOC
         => [#<Commit title: Update README.md, sha: 50c90734>, #<Commit title: Add new file, sha: 6534a685>]

data/lib/labclient/merge_requests/delete.rb

@@ -3,7 +3,7 @@ module LabClient
   # Specifics
   class MergeRequests < Common
     doc 'Delete' do
-      desc 'Only for admins and project owners. Deletes the merge request in question. [project id, merge request iid]'
+      desc 'Only for admins and project owners. Deletes the merge request in question. [Project ID, merge request iid]'
 
       example 'client.merge_requests.delete(343, 2)'
 

data/lib/labclient/merge_requests/diff_versions.rb

@@ -4,7 +4,7 @@ module LabClient
   class MergeRequests < Common
     doc 'Diff' do
       title 'Versions'
-      desc 'Get a list of merge request diff versions. [project id, mr iid]'
+      desc 'Get a list of merge request diff versions. [Project ID, mr iid]'
       example 'client.merge_requests.diff_versions(333,1)'
       result <<~DOC
         => [#<MergeRequestDiff id: 3, MR: 1, state: collected>, #<MergeRequestDiff id: 2, MR: 1, state: collected>, ..]

data/lib/labclient/merge_requests/participants.rb

@@ -4,7 +4,7 @@ module LabClient
   class MergeRequests < Common
     doc 'Show' do
       title 'Participants'
-      desc 'Get a list of merge request participants. [project id, mr iid]'
+      desc 'Get a list of merge request participants. [Project ID, mr iid]'
       example 'client.merge_requests.participants(333,1)'
       result <<~DOC
         => [#<User id: 1, username: braum>, #<User id: 52, username: anivia>]

data/lib/labclient/merge_requests/pipelines.rb

@@ -4,7 +4,7 @@ module LabClient
   class MergeRequests < Common
     doc 'Pipelines' do
       title 'List'
-      desc 'Get a list of merge request pipelines. [project id, mr iid]'
+      desc 'Get a list of merge request pipelines. [Project ID, mr iid]'
       example 'client.merge_requests.pipelines(343,1)'
       result <<~DOC
         => [#<Pipeline id: 4, ref: branch, status: success>]
@@ -33,7 +33,7 @@ module LabClient
 
     doc 'Pipelines' do
       title 'Create'
-      desc 'Create a new pipeline for a merge request. Requires .gitlab-ci.yml to be configured with only: [merge_requests] to create jobs. [project id, mr iid]'
+      desc 'Create a new pipeline for a merge request. Requires .gitlab-ci.yml to be configured with only: [merge_requests] to create jobs. [Project ID, mr iid]'
       example 'client.merge_requests.create_pipeline(343, 1)'
       result <<~DOC
         => #<Pipeline id: 7, ref: refs/merge-requests/1/head, status: pending>

data/lib/labclient/merge_requests/rebase.rb

@@ -4,7 +4,7 @@ module LabClient
   class MergeRequests < Common
     doc 'Update' do
       title 'Rebase'
-      desc 'Rebase a merge request [project id, merge request iid, skip_ci (true/false)]'
+      desc 'Rebase a merge request [Project ID, merge request iid, skip_ci (true/false)]'
       markdown <<~DOC
         - Automatically rebase the `source_branch` of the merge request against its `target_branch`.
 

data/lib/labclient/merge_requests/show.rb

@@ -3,7 +3,7 @@ module LabClient
   # Specifics
   class MergeRequests < Common
     doc 'Show' do
-      desc 'Shows information about a single merge request. [project id, mr iid]'
+      desc 'Shows information about a single merge request. [Project ID, mr iid]'
       example 'client.merge_requests.show(333,1)'
       result <<~DOC
         => #<MergeRequest id: 37, title: Add new file>

data/lib/labclient/merge_requests/subscribe.rb

@@ -4,7 +4,7 @@ module LabClient
   class MergeRequests < Common
     doc 'Update' do
       title 'Subscribe'
-      desc 'Subscribes the authenticated user to a merge request to receive notification. [project id, merge request iid]'
+      desc 'Subscribes the authenticated user to a merge request to receive notification. [Project ID, merge request iid]'
 
       example 'client.merge_requests.subscribe(343, 7)'
 

data/lib/labclient/merge_requests/time_stats.rb

@@ -4,7 +4,7 @@ module LabClient
   class MergeRequests < Common
     doc 'Time Stats' do
       title 'Show'
-      desc 'Get time tracking stats. [project id, mr iid]'
+      desc 'Get time tracking stats. [Project ID, mr iid]'
       example 'client.merge_requests.time_stats(333, 1)'
       result <<~DOC
         => {:time_estimate=>0, :total_time_spent=>0, :human_time_estimate=>nil, :human_total_time_spent=>nil}
@@ -28,7 +28,7 @@ module LabClient
 
     doc 'Time Stats' do
       title 'Add'
-      desc 'Adds spent time for this merge request. [project id, mr iid, duration]'
+      desc 'Adds spent time for this merge request. [Project ID, mr iid, duration]'
       markdown 'Duration accepts Human Format, or ActiveSupport::Duration (e.g. 1.hour)'
     end
 
@@ -67,7 +67,7 @@ module LabClient
 
     doc 'Time Stats' do
       title 'Estimate'
-      desc 'Sets an estimated time of work for this merge request. [project id, mr iid, duration]'
+      desc 'Sets an estimated time of work for this merge request. [Project ID, mr iid, duration]'
       markdown 'Duration accepts Human Format, or ActiveSupport::Duration (e.g. 1.hour)'
     end
 
@@ -108,7 +108,7 @@ module LabClient
     doc 'Time Stats' do
       title 'Reset'
       subtitle 'Estimate'
-      desc 'Resets the estimated time for this merge request to 0 seconds. [project id, mr iid]'
+      desc 'Resets the estimated time for this merge request to 0 seconds. [Project ID, mr iid]'
       example 'client.merge_requests.reset_time_estimate(333, 1)'
       result <<~DOC
         => {:time_estimate=>0, :total_time_spent=>0, :human_time_estimate=>nil, :human_total_time_spent=>nil}
@@ -132,7 +132,7 @@ module LabClient
 
     doc 'Time Stats' do
       subtitle 'Time Spent'
-      desc 'Resets the estimated time for this merge request to 0 seconds. [project id, mr iid]'
+      desc 'Resets the estimated time for this merge request to 0 seconds. [Project ID, mr iid]'
       example 'client.merge_requests.reset_spent_time(333, 1)'
       result <<~DOC
         => {:time_estimate=>0, :total_time_spent=>0, :human_time_estimate=>nil, :human_total_time_spent=>nil}

data/lib/labclient/merge_requests/todo.rb

@@ -4,7 +4,7 @@ module LabClient
   class MergeRequests < Common
     doc 'Update' do
       title 'Todo'
-      desc 'Manually creates a todo for the current user on a merge request. [project id, merge request iid]'
+      desc 'Manually creates a todo for the current user on a merge request. [Project ID, merge request iid]'
 
       example 'client.merge_requests.todo(343, 7)'
 

data/lib/labclient/merge_requests/unsubscribe.rb

@@ -4,7 +4,7 @@ module LabClient
   class MergeRequests < Common
     doc 'Update' do
       title 'Unsubscribe'
-      desc 'Subscribes the authenticated user to a merge request to receive notification. [project id, merge request iid]'
+      desc 'Subscribes the authenticated user to a merge request to receive notification. [Project ID, merge request iid]'
 
       example 'client.merge_requests.unsubscribe(343, 7)'
 

data/lib/labclient/merge_requests/update.rb

@@ -3,7 +3,7 @@ module LabClient
   # Specifics
   class MergeRequests < Common
     doc 'Update' do
-      desc 'Updates an existing merge request. You can change the target branch, title, or even close the MR. [project id, merge request iid]'
+      desc 'Updates an existing merge request. You can change the target branch, title, or even close the MR. [Project ID, merge request iid]'
 
       example <<~DOC
         client.merge_requests.update(343, 2, {

data/lib/labclient/overview.rb

@@ -173,6 +173,24 @@ module LabClient
       DOC
     end
 
+    doc 'Other' do
+      title 'Object Helpers'
+      markdown <<~DOC
+        Each created object will have additional helper methods
+      DOC
+
+      result <<~DOC
+        project = client.projects.show(5)
+
+        # Awesome Print all details
+        project.verbose
+
+        # Awesome Print all details
+        project.valid_group_project_levels
+        # => [:guest, :reporter, :developer, :maintainer, :owner]
+      DOC
+    end
+
     doc 'Other' do
       title 'Object IDs'
 

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

@@ -24,7 +24,6 @@ module LabClient
     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]'

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

@@ -36,7 +36,6 @@ module LabClient
     date_time_attrs %i[created_at]
 
     help do
-      @group_name = 'Projects'
       subtitle 'ProjectBadge'
       option 'project', 'Show Project'
       option 'update', 'Update this badge [Hash]'

data/lib/labclient/projects/clusters/project_cluster.rb

@@ -28,7 +28,6 @@ module LabClient
     user_attrs %i[uster]
 
     help do
-      @group_name = 'Projects'
       subtitle 'ProjectCluster'
       option 'project', 'Show Project'
       option 'update', 'Update this Cluster [Hash]'

data/lib/labclient/projects/create.rb

@@ -32,6 +32,16 @@ module LabClient
       example 'client.projects.create(name: "Verbal", description: "hes gone", visibility:  :private)'
     end
 
+    doc 'Create' do
+      desc 'Via Group'
+      example <<~DOC
+        group = client.groups.show(51)
+        group.project_create(name: "Hobby", description: "We do have time for your darned hobbies!")
+      DOC
+
+      example 'client.projects.create(name: "Verbal", description: "hes gone", visibility:  :private)'
+    end
+
     doc 'Create' do
       title 'For User'
       desc 'Creates a new project owned by the specified user [user id, params]'
@@ -42,7 +52,10 @@ module LabClient
       client.request(:post, "projects/user/#{user_id}", Project, query)
     end
 
+    # TODO: Test Project/Group Creation
+    # TODO: Create helper for group
     def create(query = {})
+      format_query_id(:namespace_id, query)
       client.request(:post, 'projects', Project, query)
     end
   end

data/lib/labclient/projects/deployments/project_deployment.rb

@@ -28,11 +28,9 @@ module LabClient
     user_attrs %i[user]
 
     help do
-      @group_name = 'Projects'
-      subtitle 'ProjectDeployment'
+      subtitle 'Project Deployment'
       option 'project', 'Show Project'
       option 'update', 'Update this deployment [Hash]'
-      option 'delete', 'Delete this deployment'
       option 'stop', 'Stop this deployment'
     end
   end

data/lib/labclient/projects/environments/project_environment.rb

@@ -33,7 +33,6 @@ module LabClient
     date_time_attrs %i[created_at]
 
     help do
-      @group_name = 'Projects'
       subtitle 'ProjectEnvironment'
       option 'project', 'Show Project'
       option 'update', 'Update this environment [Hash]'

data/lib/labclient/projects/forks/existing.rb

@@ -2,8 +2,6 @@
 module LabClient
   # Specifics
   class Projects < Common
-    @group_name = 'Forks'
-
     doc 'Associate' do
       desc 'Create a forked from/to relation between existing projects [Target ID, Source ID]'
       example 'client.projects.fork_existing(309, 10)'

data/lib/labclient/projects/forks/fork.rb

@@ -2,7 +2,7 @@
 module LabClient
   # Specifics
   class Projects < Common
-    @group_name = 'Forks'
+    @group_name = 'Project Forks'
 
     doc 'Create' do
       desc 'Forks a project into the user namespace of the authenticated user or the one provided.'

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

@@ -2,7 +2,6 @@
 module LabClient
   # Specifics
   class Projects < Common
-    @group_name = 'Forks'
     doc 'List' do
       desc 'List the projects accessible to the calling user that have an established, forked relationship with the specified project'
       example 'client.projects.forks(299)'

data/lib/labclient/projects/forks/remove.rb

@@ -2,7 +2,6 @@
 module LabClient
   # Specifics
   class Projects < Common
-    @group_name = 'Forks'
     doc 'Remove' do
       desc 'Delete an existing forked from relationship [Project ID]'
       example 'client.projects.fork_remove(309)'

data/lib/labclient/projects/hooks/project_hook.rb

@@ -22,7 +22,6 @@ module LabClient
     date_time_attrs %i[created_at]
 
     help do
-      @group_name = 'Projects'
       subtitle 'ProjectHook'
       option 'project', 'Show Project'
       option 'update', 'Update this hook [Hash]'

data/lib/labclient/projects/labels/project_label.rb

@@ -43,7 +43,6 @@ module LabClient
     end
 
     help do
-      @group_name = 'Projects'
       subtitle 'ProjectLabel'
       option 'project', 'Show Project'
       option 'update', 'Update this label [Hash]'

data/lib/labclient/projects/methods.rb

@@ -75,10 +75,15 @@ module LabClient
       update_self(client.projects.fork_existing(id, target_id))
     end
 
+    # Issues
     def issues(query = {})
       client.issues.project_issues(id, query)
     end
 
+    def issue_create(query)
+      client.issues.create(id, query)
+    end
+
     # Hooks
     def hooks
       client.projects.hooks.list(id)

data/lib/labclient/projects/mirrors/project_mirror.rb

@@ -21,7 +21,6 @@ module LabClient
     date_time_attrs %i[last_update_started_at last_successful_update_at]
 
     help do
-      @group_name = 'Projects'
       subtitle 'ProjectMirror'
       option 'project', 'Show Project'
       option 'update', 'Update this Mirror [Hash]'

data/lib/labclient/projects/reference.rb

@@ -12,7 +12,10 @@ module LabClient
       option 'fork_remove', 'Remove Fork Relationshgip'
       option 'fork', 'Fork this project, accepts hash, [namespace, path, name]'
       option 'forks', 'List forks of this project'
+
+      # Issues
       option 'issues', 'List project issues [Hash]'
+      option 'issue_create', 'Create a new issue in this project [Hash]'
 
       option 'housekeeping', 'Start the Housekeeping'
       option 'languages', 'Get percentage value of languages used.'

data/lib/labclient/projects/release_links/project_release_link.rb

@@ -32,7 +32,6 @@ module LabClient
     date_time_attrs %i[created_at release_linkd_at]
 
     help do
-      @group_name = 'Projects'
       subtitle 'ProjectRelease'
       option 'project', 'Show Project'
       option 'update', 'Update this release link [Hash]'

data/lib/labclient/projects/releases/project_release.rb

@@ -46,7 +46,6 @@ module LabClient
     date_time_attrs %i[created_at released_at]
 
     help do
-      @group_name = 'Projects'
       subtitle 'ProjectRelease'
       option 'project', 'Show Project'
       option 'update', 'Update this release [Hash]'

data/lib/labclient/projects/services/project_service.rb

@@ -27,7 +27,6 @@ module LabClient
     date_time_attrs %i[created_at updated_at]
 
     help do
-      @group_name = 'Projects'
       subtitle 'ProjectService'
       option 'project', 'Show Project'
       option 'update', 'Update this service [Hash]'

data/lib/labclient/projects/stars/star.rb

@@ -2,8 +2,6 @@
 module LabClient
   # Specifics
   class Projects < Common
-    @group_name = 'Stars'
-
     doc 'Star' do
       desc 'Stars a given project'
       example 'client.projects.star(10)'

data/lib/labclient/projects/stars/starred_projects.rb

@@ -2,8 +2,6 @@
 module LabClient
   # Specifics
   class Projects < Common
-    @group_name = 'Stars'
-
     doc 'List' do
       desc 'Get a list of projects starred by the given user. [user id]'
       example 'client.projects.starred(5)'

data/lib/labclient/projects/stars/starrers.rb

@@ -2,7 +2,7 @@
 module LabClient
   # Specifics
   class Projects < Common
-    @group_name = 'Stars'
+    @group_name = 'Project Stars'
 
     doc 'Starrers' do
       desc 'List the users who starred the specified project. [user id]'

data/lib/labclient/projects/triggers/project_trigger.rb

@@ -22,7 +22,6 @@ module LabClient
     user_attrs %i[owner]
 
     help do
-      @group_name = 'Projects'
       subtitle 'ProjectTrigger'
       option 'project', 'Show Project'
       option 'update', 'Update this variable [Hash]'

data/lib/labclient/projects/variables/project_variable.rb

@@ -31,7 +31,6 @@ module LabClient
     end
 
     help do
-      @group_name = 'Projects'
       subtitle 'ProjectVariable'
       option 'project', 'Show Project'
       option 'update', 'Update this variable [Hash]'

data/lib/labclient/version.rb

@@ -1,3 +1,3 @@
 module LabClient
-  VERSION = '0.1.0'.freeze
+  VERSION = '0.1.1'.freeze
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: labclient
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Davin Walker
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-05-23 00:00:00.000000000 Z
+date: 2020-06-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -442,6 +442,7 @@ files:
 - lib/labclient/groups/runners.rb
 - lib/labclient/groups/search.rb
 - lib/labclient/groups/show.rb
+- lib/labclient/groups/stub.rb
 - lib/labclient/groups/subgroups.rb
 - lib/labclient/groups/transfer.rb
 - lib/labclient/groups/update.rb