chemlab 0.0.1

data/qa/resource/project.rb

@@ -0,0 +1,179 @@
+# frozen_string_literal: true
+
+require 'securerandom'
+
+module QA
+  module Resource
+    class Project < Base
+      include Events::Project
+      include Members
+      include Visibility
+
+      attr_accessor :repository_storage # requires admin access
+      attr_writer :initialize_with_readme
+      attr_writer :auto_devops_enabled
+
+      attribute :id
+      attribute :name
+      attribute :add_name_uuid
+      attribute :description
+      attribute :standalone
+      attribute :runners_token
+      attribute :visibility
+
+      attribute :group do
+        Group.fabricate!
+      end
+
+      attribute :path_with_namespace do
+        "#{sandbox_path}#{group.path}/#{name}" if group
+      end
+
+      def sandbox_path
+        group.respond_to?('sandbox') ? "#{group.sandbox.path}/" : ''
+      end
+
+      attribute :repository_ssh_location do
+        Page::Project::Show.perform do |show|
+          show.repository_clone_ssh_location
+        end
+      end
+
+      attribute :repository_http_location do
+        Page::Project::Show.perform do |show|
+          show.repository_clone_http_location
+        end
+      end
+
+      def initialize
+        @add_name_uuid = true
+        @standalone = false
+        @description = 'My awesome project'
+        @initialize_with_readme = false
+        @auto_devops_enabled = false
+        @visibility = :public
+      end
+
+      def name=(raw_name)
+        @name = @add_name_uuid ? "#{raw_name}-#{SecureRandom.hex(8)}" : raw_name
+      end
+
+      def fabricate!
+        unless @standalone
+          group.visit!
+          Page::Group::Show.perform(&:go_to_new_project)
+        end
+
+        Page::Project::New.perform do |new_page|
+          new_page.choose_test_namespace
+          new_page.choose_name(@name)
+          new_page.add_description(@description)
+          new_page.set_visibility(@visibility)
+          new_page.enable_initialize_with_readme if @initialize_with_readme
+          new_page.create_new_project
+        end
+      end
+
+      def fabricate_via_api!
+        resource_web_url(api_get)
+      rescue ResourceNotFoundError
+        super
+      end
+
+      def api_get_path
+        "/projects/#{CGI.escape(path_with_namespace)}"
+      end
+
+      def api_visibility_path
+        "/projects/#{id}"
+      end
+
+      def api_get_archive_path(type = 'tar.gz')
+        "#{api_get_path}/repository/archive.#{type}"
+      end
+
+      def api_members_path
+        "#{api_get_path}/members"
+      end
+
+      def api_runners_path
+        "#{api_get_path}/runners"
+      end
+
+      def api_put_path
+        "/projects/#{id}"
+      end
+
+      def api_post_path
+        '/projects'
+      end
+
+      def api_post_body
+        post_body = {
+          name: name,
+          description: description,
+          visibility: @visibility,
+          initialize_with_readme: @initialize_with_readme,
+          auto_devops_enabled: @auto_devops_enabled
+        }
+
+        unless @standalone
+          post_body[:namespace_id] = group.id
+          post_body[:path] = name
+        end
+
+        post_body[:repository_storage] = repository_storage if repository_storage
+
+        post_body
+      end
+
+      def change_repository_storage(new_storage)
+        put_body = { repository_storage: new_storage }
+        response = put Runtime::API::Request.new(api_client, api_put_path).url, put_body
+
+        unless response.code == HTTP_STATUS_OK
+          raise ResourceUpdateFailedError, "Could not change repository storage to #{new_storage}. Request returned (#{response.code}): `#{response}`."
+        end
+
+        wait_until do
+          reload!
+
+          api_response[:repository_storage] == new_storage
+        end
+      end
+
+      def import_status
+        response = get Runtime::API::Request.new(api_client, "/projects/#{id}/import").url
+
+        unless response.code == HTTP_STATUS_OK
+          raise ResourceQueryError, "Could not get import status. Request returned (#{response.code}): `#{response}`."
+        end
+
+        result = parse_body(response)
+
+        Runtime::Logger.error("Import failed: #{result[:import_error]}") if result[:import_status] == "failed"
+
+        result[:import_status]
+      end
+
+      def runners(tag_list: nil)
+        response = get Runtime::API::Request.new(api_client, "#{api_runners_path}?tag_list=#{tag_list.compact.join(',')}").url
+        parse_body(response)
+      end
+
+      def share_with_group(invitee, access_level = Resource::Members::AccessLevel::DEVELOPER)
+        post Runtime::API::Request.new(api_client, "/projects/#{id}/share").url, { group_id: invitee.id, group_access: access_level }
+      end
+
+      private
+
+      def transform_api_resource(api_resource)
+        api_resource[:repository_ssh_location] =
+          Git::Location.new(api_resource[:ssh_url_to_repo])
+        api_resource[:repository_http_location] =
+          Git::Location.new(api_resource[:http_url_to_repo])
+        api_resource
+      end
+    end
+  end
+end

data/qa/resource/project_imported_from_github.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require 'securerandom'
+
+module QA
+  module Resource
+    class ProjectImportedFromGithub < Base
+      attr_accessor :name
+      attr_writer :personal_access_token, :github_repository_path
+
+      attribute :group do
+        Group.fabricate!
+      end
+
+      def fabricate!
+        group.visit!
+
+        Page::Group::Show.perform(&:go_to_new_project)
+
+        Page::Project::New.perform(&:click_import_project)
+
+        Page::Project::New.perform(&:click_github_link)
+
+        Page::Project::Import::Github.perform do |import_page|
+          import_page.add_personal_access_token(@personal_access_token)
+          import_page.import!(@github_repository_path, @name)
+        end
+      end
+    end
+  end
+end

data/qa/resource/project_member.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module QA
+  module Resource
+    class ProjectMember < Base
+      attr_accessor :user, :project, :access_level
+      attr_reader :level
+
+      def initialize
+        @level = {
+          guest: 10,
+          reporter: 20,
+          developer: 30,
+          maintainer: 40,
+          owner: 50
+        }
+      end
+
+      def api_get_path
+        "/projects/#{project.api_resource[:id]}/members/#{user.api_resource[:id]}"
+      end
+
+      def api_post_path
+        "/projects/#{project.api_resource[:id]}/members"
+      end
+
+      def api_post_body
+        {
+          user_id: user.api_resource[:id],
+          access_level: access_level
+        }
+      end
+    end
+  end
+end

data/qa/resource/project_milestone.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module QA
+  module Resource
+    class ProjectMilestone < Base
+      attribute :id
+      attribute :title
+
+      attribute :project do
+        Project.fabricate_via_api! do |resource|
+          resource.name = 'project-with-milestone'
+        end
+      end
+
+      def initialize
+        @title = "project-milestone-#{SecureRandom.hex(4)}"
+      end
+
+      def api_get_path
+        "/projects/#{project.id}/milestones/#{id}"
+      end
+
+      def api_post_path
+        "/projects/#{project.id}/milestones"
+      end
+
+      def api_post_body
+        {
+          title: title
+        }
+      end
+    end
+  end
+end

data/qa/resource/protected_branch.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+require 'securerandom'
+
+module QA
+  module Resource
+    class ProtectedBranch < Base
+      attr_accessor :branch_name, :allowed_to_push, :allowed_to_merge, :protected
+
+      attribute :project do
+        Project.fabricate_via_api! do |resource|
+          resource.name = 'protected-branch-project'
+          resource.initialize_with_readme = true
+        end
+      end
+
+      attribute :branch do
+        Repository::ProjectPush.fabricate! do |project_push|
+          project_push.project = project
+          project_push.file_name = "new_file-#{SecureRandom.hex(8)}.md"
+          project_push.commit_message = 'Add new file'
+          project_push.branch_name = branch_name
+          project_push.new_branch = true
+          project_push.remote_branch = @branch_name
+        end
+      end
+
+      def initialize
+        @branch_name = 'test/branch'
+        @allowed_to_push = {
+          roles: Resource::ProtectedBranch::Roles::DEVS_AND_MAINTAINERS
+        }
+        @allowed_to_merge = {
+          roles: Resource::ProtectedBranch::Roles::DEVS_AND_MAINTAINERS
+        }
+        @protected = false
+      end
+
+      def fabricate!
+        populate(:branch)
+
+        project.wait_for_push_new_branch @branch_name
+
+        project.visit!
+        Page::Project::Menu.perform(&:go_to_repository_settings)
+
+        Page::Project::Settings::Repository.perform do |setting|
+          setting.expand_protected_branches do |page|
+            page.select_branch(branch_name)
+            page.select_allowed_to_merge(allowed_to_merge)
+            page.select_allowed_to_push(allowed_to_push)
+            page.protect_branch
+          end
+        end
+      end
+
+      def self.unprotect_via_api!(&block)
+        self.remove_via_api!(&block)
+      end
+
+      def api_get_path
+        "/projects/#{@project.api_resource[:id]}/protected_branches/#{@branch_name}"
+      end
+
+      def api_delete_path
+        "/projects/#{@project.api_resource[:id]}/protected_branches/#{@branch_name}"
+      end
+
+      class Roles
+        NO_ONE = 'No one'
+        DEVS_AND_MAINTAINERS = 'Developers + Maintainers'
+        MAINTAINERS = 'Maintainers'
+      end
+    end
+  end
+end

data/qa/resource/repository/commit.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+module QA
+  module Resource
+    module Repository
+      class Commit < Base
+        attr_accessor :author_email,
+                      :author_name,
+                      :branch,
+                      :commit_message,
+                      :file_path,
+                      :sha
+
+        attribute :short_id
+
+        attribute :project do
+          Project.fabricate! do |resource|
+            resource.name = 'project-with-commit'
+          end
+        end
+
+        def initialize
+          @commit_message = 'QA Test - Commit message'
+        end
+
+        def add_files(files)
+          validate_files!(files)
+
+          @add_files = files
+        end
+
+        def update_files(files)
+          validate_files!(files)
+
+          @update_files = files
+        end
+
+        def resource_web_url(resource)
+          super
+        rescue ResourceURLMissingError
+          # this particular resource does not expose a web_url property
+        end
+
+        def api_get_path
+          "#{api_post_path}/#{@sha}"
+        end
+
+        def api_post_path
+          "/projects/#{CGI.escape(project.path_with_namespace)}/repository/commits"
+        end
+
+        def api_post_body
+          {
+            branch: @branch || "master",
+            author_email: @author_email || Runtime::User.default_email,
+            author_name: @author_name || Runtime::User.username,
+            commit_message: commit_message,
+            actions: actions
+          }
+        end
+
+        def actions
+          pending_actions = []
+          pending_actions << @add_files.map { |file| file.merge({ action: "create" }) } if @add_files
+          pending_actions << @update_files.map { |file| file.merge({ action: "update" }) } if @update_files
+          pending_actions.flatten
+        end
+
+        private
+
+        def validate_files!(files)
+          if !files.is_a?(Array) ||
+              files.empty? ||
+              files.any? { |file| !file.has_key?(:file_path) || !file.has_key?(:content) }
+            raise ArgumentError, "Please provide an array of hashes e.g.: [{file_path: 'file1', content: 'foo'}]"
+          end
+        end
+      end
+    end
+  end
+end

data/qa/resource/repository/project_push.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+require 'securerandom'
+
+module QA
+  module Resource
+    module Repository
+      class ProjectPush < Repository::Push
+        attr_accessor :project_name
+        attr_writer :wait_for_push
+
+        attribute :project do
+          Project.fabricate! do |resource|
+            resource.name = project_name
+            resource.description = 'Project with repository'
+          end
+        end
+
+        def initialize
+          @file_name = "file-#{SecureRandom.hex(8)}.txt"
+          @file_content = '# This is test project'
+          @commit_message = "This is a test commit"
+          @branch_name = 'master'
+          @new_branch = true
+          @project_name = 'project-with-code'
+          @wait_for_push = true
+        end
+
+        def repository_http_uri
+          @repository_http_uri ||= project.repository_http_location.uri
+        end
+
+        def repository_ssh_uri
+          @repository_ssh_uri ||= project.repository_ssh_location.uri
+        end
+
+        def fabricate!
+          super
+          project.wait_for_push @commit_message if @wait_for_push
+        end
+      end
+    end
+  end
+end