labclient 0.2.0 → 0.3.3

data/lib/labclient/feature_flags/create.rb

@@ -0,0 +1,48 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class FeatureFlags < Common
+    doc 'Create' do
+      title 'Set or create a feature'
+      example 'client.feature_flags.create(:create_eks_clusters, value: true)'
+      result <<~DOC
+        => #<FeatureFlag name: create_eks_clusters, state: on
+      DOC
+    end
+
+    doc 'Attributes' do
+      desc 'Register a new Application'
+      markdown <<~DOC
+        | Attribute | Type | Required | Description |
+        | --------- | ---- | -------- | ----------- |
+        | name | string | yes | Name of the feature to create or update |
+        | value | integer/string | yes | `true` or `false` to enable/disable, or an integer for percentage of time |
+        | feature_group | string | no | A Feature group name |
+        | user | string | no | A GitLab username |
+        | group | string | no | A GitLab group's path, for example gitlab-org |
+        | project | string | no | A projects path, for example gitlab-org/gitlab-foss |
+
+         Note that you can enable or disable a feature for a `feature_group`, a `user`,
+         a `group`, and a `project` in a single API call.
+      DOC
+    end
+
+    doc 'Create' do
+      example <<~DOC
+        client.applications.create(
+          name: "Grafana",
+          redirect_uri: "https://gitlab.com/-/grafana/login/gitlab",
+          scopes: "email"
+        )
+      DOC
+      result <<~DOC
+        #<Application id: 11, Grafana>
+      DOC
+    end
+
+    # Create
+    def create(name, query = {})
+      client.request(:post, "features/#{name}", FeatureFlag, query)
+    end
+  end
+end

data/lib/labclient/feature_flags/delete.rb

@@ -0,0 +1,23 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class FeatureFlags < Common
+    doc 'Delete' do
+      title 'Delete a feature'
+      example 'client.feature_flags.delete(:name)'
+    end
+
+    doc 'Delete' do
+      desc 'Delete via FeatureFlag'
+      example <<~DOC
+        feature = client.feature_flags.list.first
+        feature.delete
+      DOC
+    end
+
+    # Delete
+    def delete(name)
+      client.request(:delete, "features/#{name}")
+    end
+  end
+end

data/lib/labclient/feature_flags/feature_flag.rb

@@ -0,0 +1,35 @@
+# Top namespace
+module LabClient
+  # Inspect Helper
+  class FeatureFlag < Klass
+    include ClassHelpers
+    def inspect
+      "#<FeatureFlag name: #{name}, state: #{state}>"
+    end
+
+    def delete
+      client.feature_flags.delete name
+    end
+
+    def update(query)
+      update_self client.feature_flags.create(name, query)
+    end
+
+    def toggle
+      if state == 'off'
+        update(value: true)
+      else
+        update(value: false)
+      end
+    end
+
+    date_time_attrs %i[created_at]
+
+    help do
+      subtitle 'Feature Flag'
+      option 'delete', 'Delete this specific feature flag'
+      option 'toggle', 'Disable / Turn on feature'
+      option 'update', 'Create flag / Update with values [Hash]'
+    end
+  end
+end

data/lib/labclient/feature_flags/list.rb

@@ -0,0 +1,49 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class FeatureFlags < Common
+    doc 'List' do
+      title 'List all features'
+      desc 'Get a list of all persisted features, with its gate values.'
+      example 'client.feature_flags.list'
+      result <<~DOC
+        =>  [#<Feature name: create_eks_clusters, state: on>]
+      DOC
+    end
+
+    doc 'List' do
+      title 'View detail of features'
+      desc 'Retrieve detailed information of feature flags'
+      example 'client.feature_flags.list.each(&:verbose)'
+      result <<~DOC
+        LabClient::Feature {
+                            :name => "create_eks_clusters",
+                            :state => "on",
+                            :gates => [
+                              [0] OpenStruct {
+                                    :key => "boolean",
+                                    :value => true
+                              }
+                            ]
+        }
+        => [#<Feature name: create_eks_clusters, state: on>]
+      DOC
+    end
+
+    doc 'List' do
+      title 'Toggle all features on or off'
+      example <<~DOC
+        client.feature_flags.list.each(&:toggle)
+      DOC
+      result <<~DOC
+        [#<Feature name: create_eks_clusters, state: off>,
+         #<Feature name: merge_train1, state: off>,
+         #<Feature name: merge_train2, state: off>]
+      DOC
+    end
+
+    def list
+      client.request(:get, 'features', FeatureFlag)
+    end
+  end
+end

data/lib/labclient/files/update.rb

@@ -33,7 +33,7 @@ module LabClient
       desc 'via Project'
       example <<~DOC
         project = client.projects.show(264)
-        project.file_create('other.md',
+        project.file_update('other.md',
           branch: :master,
           commit_message: "New File!",
           content: "Content!")

data/lib/labclient/generator/generator.rb

@@ -26,6 +26,16 @@ module LabClient
         example 'gem install faker'
       end
 
+      doc 'Wizard' do
+        title 'Quickstart'
+        desc 'To run, create the client/wizard and run!'
+        example <<~DOC
+          require 'labclient'
+          client = LabClient::Client.new(url: 'https://labclient', token: 'super_secret')
+          client.wizard.run!
+        DOC
+      end
+
       doc 'Wizard' do
         title 'Client'
         desc <<-DOC

data/lib/labclient/generator/wizard.rb

@@ -26,7 +26,7 @@ module LabClient
         self.random = true # Populate Random or use only Templates
         self.count = default_count
         self.password = SecureRandom.uuid
-        puts "Default Password: #{password}"
+        puts "Default Password: #{password}" unless client.quiet?
 
         self.skip_confirmation = true
         self.domain = URI.parse(client.settings[:url]).hostname
@@ -54,11 +54,11 @@ module LabClient
       end
 
       def generate_users
-        puts 'Generating Users'
+        puts 'Generating Users' unless client.quiet?
         @users = @user_names.map do |name|
           username = name.downcase.gsub(/[^0-9A-Za-z]/, '')
           email = "#{username}@#{domain}"
-          puts "User -- Name: #{name}, UserName: #{username}, Email: #{email}"
+          puts "User -- Name: #{name}, UserName: #{username}, Email: #{email}" unless client.quiet?
 
           client.users.create(
             name: name,
@@ -71,39 +71,41 @@ module LabClient
       end
 
       def generate_groups
-        puts 'Generating Groups'
+        puts 'Generating Groups' unless client.quiet?
         @groups = @group_names.map do |name|
           path = name.downcase.gsub(/[^0-9A-Za-z]/, '')
-          puts "Group -- #{name}/#{path}"
+          puts "Group -- #{name}/#{path}" unless client.quiet?
           client.groups.create(name: name, path: path)
         end
       end
 
+      # rubocop:disable Metrics/AbcSize
       def generate_group_membership
-        puts 'Adding Group members'
+        puts 'Adding Group members' unless client.quiet?
         ## Group Access Level
         @groups.each do |group|
           @users.sample(rand(1..@users.count)).each do |user|
             level = group.valid_group_project_levels.sample
-            puts "Group Add: #{group.name}: #{user.name} - #{level}"
+            puts "Group Add: #{group.name}: #{user.name} - #{level}" unless client.quiet?
             group.member_add(user, access_level: level)
             # :nocov:
           rescue StandardError => e
-            puts e.message
+            puts e.message unless client.quiet?
             next
             # :nocov:
           end
         end
       end
+      # rubocop:enable Metrics/AbcSize
 
       def generate_projects(group)
-        puts 'Generating Projects'
+        puts 'Generating Projects' unless client.quiet?
         # Collect Group Members
         members = group.members
 
         # Loop through project names, create project add issues
         @project_names.uniq.map do |project_name|
-          puts "Project: #{project_name}"
+          puts "Project: #{project_name}" unless client.quiet?
           project = group.project_create(name: project_name, description: gen_description)
 
           rand(count[:issues]).times do

data/lib/labclient/groups/clusters/add.rb

@@ -0,0 +1,46 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class GroupClusters < Common
+    doc 'Add' do
+      desc 'Adds an existing Kubernetes cluster to the group. [Group ID, Hash]'
+      example <<~DOC
+        params = {
+          name: 'cluster-5',
+          platform_kubernetes_attributes: {
+            api_url: 'https://35.111.51.20',
+            token: '12345',
+            ca_cert: "-----BEGIN .....-----END CERTIFICATE-----"
+          }
+        }
+
+          client.groups.clusters.add(310, params)
+      DOC
+
+      result '=>  #<GroupCluster id: 2, name: cluster-5>'
+    end
+
+    doc 'Add' do
+      markdown <<~DOC
+        | Attribute | Type | Required | Description |
+        | --------- | ---- | -------- | ----------- |
+        | name      | string | yes | The name of the cluster |
+        | domain      | string | no | The base domain of the cluster |
+        | management_project_id | integer | no | The ID of the management project for the cluster |
+        | enabled      | boolean | no | Determines if cluster is active or not, defaults to true |
+        | managed      | boolean | no | Determines if GitLab will manage namespaces and service accounts for this cluster, defaults to true |
+        | platform_kubernetes_attributes[api_url] | string | yes | The URL to access the Kubernetes API |
+        | platform_kubernetes_attributes[token] | string | yes | The token to authenticate against Kubernetes |
+        | platform_kubernetes_attributes[ca_cert] | string | no | TLS certificate. Required if API is using a self-signed TLS certificate. |
+        | platform_kubernetes_attributes[authorization_type] | string | no | The cluster authorization type: rbac, abac or unknown_authorization. Defaults to rbac. |
+        | environment_scope | string | no | The associated environment to the cluster. Defaults to * **(PREMIUM)** |
+      DOC
+    end
+
+    def add(group_id, query)
+      group_id = format_id(group_id)
+
+      client.request(:post, "groups/#{group_id}/clusters/user", GroupCluster, query)
+    end
+  end
+end

data/lib/labclient/groups/clusters/client.rb

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

data/lib/labclient/groups/clusters/delete.rb

@@ -0,0 +1,36 @@
+# Top namespace
+module LabClient
+  # Specifics
+  class GroupClusters < Common
+    doc 'Delete' do
+      desc 'Deletes an existing group cluster. [Project ID, Mirror ID, Params]'
+      example 'client.group.clusters.update(310, 3, enabled: true)'
+
+      result '=>  #<GroupCluster id: 3, name: planet bob>'
+    end
+
+    doc 'Delete' do
+      markdown <<~DOC
+        | Attribute              | Type    | Required   | Description                                         |
+        | ----------             | -----   | ---------  | ------------                                        |
+        | `id` | integer/string | yes | The ID or URL-encoded path of the group |
+        | `cluster_id` | integer | yes | The ID of the cluster |
+      DOC
+    end
+
+    doc 'Delete' do
+      desc 'Via GroupCluster [Params]'
+      example <<~DOC
+        cluster = client.groups.clusters.list(310).first
+        cluster.delete
+      DOC
+    end
+
+    def delete(group_id, cluster_id)
+      group_id = format_id(group_id)
+      cluster_id = format_id(cluster_id)
+
+      client.request(:delete, "groups/#{group_id}/clusters/#{cluster_id}", GroupCluster)
+    end
+  end
+end