labclient 0.1.0

data/lib/labclient/users/activity.rb

@@ -0,0 +1,23 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class Users < Common
+    doc 'Show' do
+      title 'Activity'
+      desc 'Get the last activity date for all users, sorted from oldest to newest. [User ID, Date (YYYY-MM-DD)]'
+
+      example 'client.users.activity(1.year.ago)'
+      result <<~DOC
+        [
+          {:username=>"shelob", :last_activity_on=>"2020-03-27", :last_activity_at=>"2020-03-27"}, {:username=>"root", :last_activity_on=>"2020-03-27", :last_activity_at=>"2020-03-27"}
+        ]
+      DOC
+    end
+
+    def activity(from_date)
+      query = { from: from_date }
+      query_format_time(query, :from)
+      client.request(:get, 'user/activities', nil, query)
+    end
+  end
+end

data/lib/labclient/users/block.rb

@@ -0,0 +1,25 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class Users < Common
+    doc 'Update' do
+      title 'Block'
+      desc 'Blocks the specified user [User ID]'
+      example 'client.users.block(57)'
+    end
+
+    doc 'Update' do
+      desc 'Via User'
+      example <<~DOC
+        user = client.users.show(57)
+        user.block
+      DOC
+    end
+
+    def block(user_id)
+      user_id = format_id(user_id)
+
+      client.request(:post, "users/#{user_id}/block")
+    end
+  end
+end

data/lib/labclient/users/counts.rb

@@ -0,0 +1,16 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class Users < Common
+    doc 'Show' do
+      title 'Counts'
+      desc 'Get the counts of the authenticated user.'
+      example 'client.users.counts'
+      result '{:merge_requests=>0}'
+    end
+
+    def counts
+      client.request(:get, 'user_counts')
+    end
+  end
+end

data/lib/labclient/users/create.rb

@@ -0,0 +1,25 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class Users < Common
+    doc 'Create' do
+      desc 'Create a new user. Available only for administrators [Hash]'
+      example <<~DOC
+        client.users.create(
+          name:  "Lorenzo Trudgealong",
+          email:"speed@labclient",
+          username: "speed", password:"supersecure"
+        )
+      DOC
+      result '#<User id: 57, username: speed>'
+
+      markdown <<~DOC
+        Required Parameters: `email`, `name`, and `username`. See [docs](https://docs.gitlab.com/ee/api/users.html#user-creation) for all available parameters
+      DOC
+    end
+
+    def create(query)
+      client.request(:post, 'users', User, query)
+    end
+  end
+end

data/lib/labclient/users/current.rb

@@ -0,0 +1,28 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class Users < Common
+    doc 'Show' do
+      title 'Current'
+      desc 'Gets currently authenticated user'
+      example 'client.users.current'
+      result '#<User id: 1, username: root>'
+    end
+
+    doc 'Show' do
+      desc 'Sudo make call user place [User ID]'
+      example 'client.users.current(12)'
+      result '#<User id: 12, username: antonidas>'
+    end
+
+    # Display single user
+    def current(sudo_id = nil)
+      if sudo_id
+        sudo_id = format_id(sudo_id)
+        client.request(:get, 'user', User, sudo: sudo_id)
+      else
+        client.request(:get, 'user', User)
+      end
+    end
+  end
+end

data/lib/labclient/users/deactivate.rb

@@ -0,0 +1,25 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class Users < Common
+    doc 'Update' do
+      title 'Block'
+      desc 'Deactivates the specified user [User ID]'
+      example 'client.users.deactivate(57)'
+    end
+
+    doc 'Update' do
+      desc 'Via User'
+      example <<~DOC
+        user = client.users.show(57)
+        user.deactivate
+      DOC
+    end
+
+    def deactivate(user_id)
+      user_id = format_id(user_id)
+
+      client.request(:post, "users/#{user_id}/deactivate")
+    end
+  end
+end

data/lib/labclient/users/delete.rb

@@ -0,0 +1,28 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class Users < Common
+    doc 'Delete' do
+      desc 'Deletes a user. Available only for administrators. [User ID]'
+      example 'client.users.delete(57)'
+      result '=> nil'
+
+      markdown <<~DOC
+        See [docs](https://docs.gitlab.com/ee/api/users.html#user-modification) for all available parameters
+      DOC
+    end
+
+    doc 'Delete' do
+      desc 'Via User'
+      example <<~DOC
+        user = client.users.show(57)
+        user.delete
+      DOC
+    end
+
+    def delete(user_id)
+      user_id = format_id(user_id)
+      client.request(:delete, "users/#{user_id}")
+    end
+  end
+end

data/lib/labclient/users/delete_identity.rb

@@ -0,0 +1,25 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class Users < Common
+    doc 'Delete' do
+      title 'Identity'
+      desc 'Deletes a user’s authentication identity using the provider name associated with that identity. [User ID, Provider]'
+      example 'client.users.delete_identity(57, "ldapmain")'
+      result '=> nil'
+    end
+
+    doc 'Delete' do
+      desc 'Via User'
+      example <<~DOC
+        user = client.users.show(57)
+        user.delete_identity(name: 'Lorenzo')
+      DOC
+    end
+
+    def delete_identity(user_id, provider)
+      user_id = format_id(user_id)
+      client.request(:delete, "users/#{user_id}/identities/#{provider}")
+    end
+  end
+end

data/lib/labclient/users/email/client.rb

@@ -0,0 +1,18 @@
+# Top namespace
+module LabClient
+  # Inspect Helper
+  class UserEmails < Common
+    @group_name = 'User Emails'
+    include ClassHelpers
+  end
+end
+
+# Top namespace
+module LabClient
+  # Specifics
+  class Users < Common
+    def emails
+      UserEmails.new(client)
+    end
+  end
+end

data/lib/labclient/users/email/create.rb

@@ -0,0 +1,37 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class UserEmails < Common
+    doc 'Create' do
+      desc 'Create new key for current or target user [String, User ID (Optional)]'
+      example 'client.users.emails.create("user@labclient")'
+      result '#<Email id: 3>'
+    end
+
+    doc 'Create' do
+      desc 'Create for Specific User'
+      example <<~DOC
+        client.users.emails.create("email@labclient",5)
+      DOC
+    end
+
+    doc 'Create' do
+      desc 'Via User'
+      example <<~DOC
+        user = client.users.show(5)
+        user.email_create("email@labclient")
+      DOC
+    end
+
+    def create(email, user_id = nil)
+      query = { email: email }
+
+      if user_id
+        user_id = format_id(user_id)
+        client.request(:post, "users/#{user_id}/emails", Email, query)
+      else
+        client.request(:post, 'user/emails', Email, query)
+      end
+    end
+  end
+end

data/lib/labclient/users/email/delete.rb

@@ -0,0 +1,33 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class UserEmails < Common
+    doc 'Delete' do
+      desc 'Delete email for current or target user [Email ID, User ID (Optional)]'
+      example 'client.users.emails.delete(2)'
+    end
+
+    doc 'Delete' do
+      desc 'Delete specific user email. [Email ID, User ID]'
+      example 'client.users.emails.delete(3,5)'
+    end
+
+    doc 'Delete' do
+      desc 'Via User [Email ID]'
+      example <<~DOC
+        user = client.users.show(5)
+        user.email_deleteemail_delete(2)
+      DOC
+    end
+
+    def delete(key_id, user_id = nil)
+      key_id = format_id(key_id)
+      if user_id
+        user_id = format_id(user_id)
+        client.request(:delete, "users/#{user_id}/emails/#{key_id}")
+      else
+        client.request(:delete, "user/emails/#{key_id}")
+      end
+    end
+  end
+end

data/lib/labclient/users/email/email.rb

@@ -0,0 +1,11 @@
+# Top namespace
+module LabClient
+  # Inspect Helper
+  class Email < Klass
+    include ClassHelpers
+
+    def inspect
+      "#<Email id: #{id}, #{email}>"
+    end
+  end
+end

data/lib/labclient/users/email/list.rb

@@ -0,0 +1,33 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class UserEmails < Common
+    doc 'List' do
+      desc 'List current or target user emails. [User ID (Optional)]'
+      example 'client.users.emails.list'
+      result '[#<GpGKey id: 1>, ...]'
+    end
+
+    doc 'List' do
+      desc 'List specific user keys.'
+      example 'client.users.emails.list(1)'
+    end
+
+    doc 'List' do
+      desc 'Via User'
+      example <<~DOC
+        user = client.users.show(5)
+        user.emails
+      DOC
+    end
+
+    def list(user_id = nil)
+      if user_id
+        user_id = format_id(user_id)
+        client.request(:get, "users/#{user_id}/emails", Email)
+      else
+        client.request(:get, 'user/emails', Email)
+      end
+    end
+  end
+end

data/lib/labclient/users/email/show.rb

@@ -0,0 +1,17 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class UserEmails < Common
+    doc 'Show' do
+      desc 'Get current user single gpg key. [Email Address]'
+      example 'client.users.emails.show(1)'
+      result '#<Email id: 1>'
+    end
+
+    def show(email_id)
+      email_id = format_id(email_id)
+
+      client.request(:get, "user/emails/#{email_id}", Email)
+    end
+  end
+end

data/lib/labclient/users/gpg/client.rb

@@ -0,0 +1,18 @@
+# Top namespace
+module LabClient
+  # Inspect Helper
+  class UserGpgKeys < Common
+    @group_name = 'GPG Keys'
+    include ClassHelpers
+  end
+end
+
+# Top namespace
+module LabClient
+  # Specifics
+  class Users < Common
+    def gpg_keys
+      UserGpgKeys.new(client)
+    end
+  end
+end

data/lib/labclient/users/gpg/create.rb

@@ -0,0 +1,37 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class UserGpgKeys < Common
+    doc 'Create' do
+      desc 'Create new key for current or target user [String, User ID (Optional)]'
+      example 'lientc.users.gpg_keys.create("-----BEGIN PGP ...")'
+      result '#<GpgKey id: 3>'
+    end
+
+    doc 'Create' do
+      desc 'Create for Specific User'
+      example <<~DOC
+        client.users.gpg_keys.create("-----BEGIN PGP...",5)
+      DOC
+    end
+
+    doc 'Create' do
+      desc 'Via User'
+      example <<~DOC
+        user = client.users.show(5)
+        user.gpg_key_create("keeeydata")
+      DOC
+    end
+
+    def create(key_data, user_id = nil)
+      query = { key: key_data }
+
+      if user_id
+        user_id = format_id(user_id)
+        client.request(:post, "users/#{user_id}/gpg_keys", GpgKey, query)
+      else
+        client.request(:post, 'user/gpg_keys', GpgKey, query)
+      end
+    end
+  end
+end

data/lib/labclient/users/gpg/delete.rb

@@ -0,0 +1,33 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class UserGpgKeys < Common
+    doc 'Delete' do
+      desc 'Delete gpg key for current or target user [GPG Key ID, User ID (Optional)]'
+      example 'client.users.gpg_keys.delete(2)'
+    end
+
+    doc 'Delete' do
+      desc 'Delete specific user gpg key. [GPG Key ID, User ID]'
+      example 'client.users.gpg_keys.delete(3,5)'
+    end
+
+    doc 'Delete' do
+      desc 'Via User [GPG Key ID]'
+      example <<~DOC
+        user = client.users.show(5)
+        user.gpg_key_delete(2)
+      DOC
+    end
+
+    def delete(key_id, user_id = nil)
+      key_id = format_id(key_id)
+      if user_id
+        user_id = format_id(user_id)
+        client.request(:delete, "users/#{user_id}/gpg_keys/#{key_id}")
+      else
+        client.request(:delete, "user/gpg_keys/#{key_id}")
+      end
+    end
+  end
+end

data/lib/labclient/users/gpg/gpg_key.rb

@@ -0,0 +1,13 @@
+# Top namespace
+module LabClient
+  # Inspect Helper
+  class GpgKey < Klass
+    include ClassHelpers
+
+    def inspect
+      "#<GpGKey id: #{id}>"
+    end
+
+    date_time_attrs %i[created_at]
+  end
+end

data/lib/labclient/users/gpg/list.rb

@@ -0,0 +1,33 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class UserGpgKeys < Common
+    doc 'List' do
+      desc 'List current or target user GPG keys. [User ID (Optional)]'
+      example 'client.users.gpg_keys.list'
+      result '[#<GpGKey id: 1>, ...]'
+    end
+
+    doc 'List' do
+      desc 'List specific user keys.'
+      example 'client.users.gpg_keys.list(1)'
+    end
+
+    doc 'List' do
+      desc 'Via User'
+      example <<~DOC
+        user = client.users.show(5)
+        user.gpg_keys
+      DOC
+    end
+
+    def list(user_id = nil)
+      if user_id
+        user_id = format_id(user_id)
+        client.request(:get, "users/#{user_id}/gpg_keys", GpgKey)
+      else
+        client.request(:get, 'user/gpg_keys', GpgKey)
+      end
+    end
+  end
+end

data/lib/labclient/users/gpg/show.rb

@@ -0,0 +1,17 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class UserGpgKeys < Common
+    doc 'Show' do
+      desc 'Get current user single gpg key. [GPG Key ID]'
+      example 'client.users.gpg_keys.show(1)'
+      result '#<GpgKey id: 1>'
+    end
+
+    def show(key_id)
+      key_id = format_id(key_id)
+
+      client.request(:get, "user/gpg_keys/#{key_id}", GpgKey)
+    end
+  end
+end

data/lib/labclient/users/keys/client.rb

@@ -0,0 +1,18 @@
+# Top namespace
+module LabClient
+  # Inspect Helper
+  class UserKeys < Common
+    @group_name = 'SSH Keys'
+    include ClassHelpers
+  end
+end
+
+# Top namespace
+module LabClient
+  # Specifics
+  class Users < Common
+    def keys
+      UserKeys.new(client)
+    end
+  end
+end

data/lib/labclient/users/keys/create.rb

@@ -0,0 +1,42 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class UserKeys < Common
+    doc 'Create' do
+      desc 'Create new key for current or target user [Hash, User ID (Optional)]'
+      example 'client.users.keys.create(title: "New Key!", key: "ssh-rsa AAAAB3NzaC1...")'
+      result '#<Key id: 3>'
+
+      markdown <<~DOC
+        Parameters:
+
+        - `title` (required) - new SSH Key's title
+        - `key` (required) - new SSH key
+      DOC
+    end
+
+    doc 'Create' do
+      desc 'Create for Specific User'
+      example <<~DOC
+        client.users.keys.create(title: "Another!", key: "ssh-rsa +nxI4w9F33LsCgFm0R...",5)
+      DOC
+    end
+
+    doc 'Create' do
+      desc 'Via User'
+      example <<~DOC
+        user = client.users.show(5)
+        user.key_create(title: "User Key!", key: "ssh-rsa AAA...")
+      DOC
+    end
+
+    def create(query, user_id = nil)
+      if user_id
+        user_id = format_id(user_id)
+        client.request(:post, "users/#{user_id}/keys", Key, query)
+      else
+        client.request(:post, 'user/keys', Key, query)
+      end
+    end
+  end
+end

data/lib/labclient/users/keys/delete.rb

@@ -0,0 +1,33 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class UserKeys < Common
+    doc 'Delete' do
+      desc 'Delete key for current or target user [Key ID, User ID (Optional)]'
+      example 'client.users.keys.delete(2)'
+    end
+
+    doc 'Delete' do
+      desc 'Delete Specific User Key. [Key ID, User ID]'
+      example 'client.users.keys.delete(3,5)'
+    end
+
+    doc 'Delete' do
+      desc 'Via User [Key ID]'
+      example <<~DOC
+        user = client.users.show(5)
+        user.key_delete(2)
+      DOC
+    end
+
+    def delete(key_id, user_id = nil)
+      key_id = format_id(key_id)
+      if user_id
+        user_id = format_id(user_id)
+        client.request(:delete, "users/#{user_id}/keys/#{key_id}")
+      else
+        client.request(:delete, "user/keys/#{key_id}")
+      end
+    end
+  end
+end

data/lib/labclient/users/keys/list.rb

@@ -0,0 +1,33 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class UserKeys < Common
+    doc 'List' do
+      desc 'Get a list of a user SSH keys. [User ID (Optional)]'
+      example 'client.users.keys.list'
+      result '[#<Key id: 1>, ...]'
+    end
+
+    doc 'List' do
+      desc 'List specific user keys.'
+      example 'client.users.keys.list(1)'
+    end
+
+    doc 'List' do
+      desc 'Via User'
+      example <<~DOC
+        user = client.users.show(5)
+        user.keys
+      DOC
+    end
+
+    def list(user_id = nil)
+      if user_id
+        user_id = format_id(user_id)
+        client.request(:get, "users/#{user_id}/keys", Key)
+      else
+        client.request(:get, 'user/keys', Key)
+      end
+    end
+  end
+end

data/lib/labclient/users/keys/show.rb

@@ -0,0 +1,17 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class UserKeys < Common
+    doc 'Show' do
+      desc 'Get current user single key. [Key ID]'
+      example 'client.users.keys.show(1)'
+      result '#<Key id: 1>'
+    end
+
+    def show(key_id)
+      key_id = format_id(key_id)
+
+      client.request(:get, "user/keys/#{key_id}", Key)
+    end
+  end
+end