ghub 0.0.0

data/lib/ghub/endpoints/branches/protection/container.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require "dry/container"
+
+module Ghub
+  module Endpoints
+    module Branches
+      module Protection
+        # Defines branch protection dependencies.
+        module Container
+          extend Dry::Container::Mixin
+
+          merge Ghub::Container
+
+          namespace :requests do
+            register(:update) { Requests::Update }
+          end
+
+          namespace :responses do
+            register(:show) { Responses::Show }
+          end
+
+          namespace :models do
+            register(:show) { Models::Show }
+          end
+
+          namespace :actions do
+            register(:show) { Actions::Show.new }
+            register(:update) { Actions::Update.new }
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ghub/endpoints/branches/protection/import.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require "infusible"
+
+module Ghub
+  module Endpoints
+    module Branches
+      module Protection
+        Import = Infusible.with Container
+      end
+    end
+  end
+end

data/lib/ghub/endpoints/branches/protection/models/show.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Ghub
+  module Endpoints
+    module Branches
+      module Protection
+        module Models
+          # Defines branch protection.
+          Show = Struct.new(
+            :allow_deletions,
+            :allow_force_pushes,
+            :block_creations,
+            :enforce_admins,
+            :required_conversation_resolution,
+            :required_linear_history,
+            :required_pull_request_reviews,
+            :required_signatures,
+            :required_status_checks,
+            :restrictions,
+            :url,
+            keyword_init: true
+          ) do
+            include Resultable
+
+            def self.for attributes
+              new attributes.merge(
+                enforce_admins: Ghub::Models::BooleanLink[attributes[:enforce_admins]],
+                required_signatures: Ghub::Models::BooleanLink[attributes[:required_signatures]],
+                required_status_checks: Ghub::Models::StatusCheck.for(
+                  attributes[:required_status_checks]
+                ),
+                required_pull_request_reviews: Ghub::Models::Review.for(
+                  attributes[:required_pull_request_reviews]
+                ),
+                restrictions: Ghub::Models::Restriction.for(attributes[:restrictions])
+              )
+            end
+
+            def initialize *arguments
+              super
+              freeze
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ghub/endpoints/branches/protection/requests/update.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module Ghub
+  module Endpoints
+    module Branches
+      module Protection
+        module Requests
+          # Defines the data structure for updating a protected branch.
+          Update = Dry::Schema.JSON do
+            required(:enforce_admins).filled :bool
+
+            required(:required_pull_request_reviews).maybe(:hash) do
+              optional(:bypass_pull_request_allowances).hash do
+                optional(:users).array :string
+                optional(:teams).array :string
+                optional(:apps).array :string
+              end
+
+              optional(:dismiss_stale_reviews).filled :bool
+
+              optional(:dismissal_restrictions).hash do
+                optional(:users).array :string
+                optional(:teams).array :string
+                optional(:apps).array :string
+              end
+
+              optional(:require_code_owner_reviews).filled :bool
+              optional(:required_approving_review_count).filled :integer
+            end
+
+            required(:required_status_checks).hash do
+              required(:strict).filled :bool
+              required(:contexts).array(:string)
+            end
+
+            required(:restrictions).maybe(:hash) do
+              required(:users).array :string
+              required(:teams).array :string
+              optional(:apps).array :string
+            end
+
+            optional(:allow_deletions).filled :bool
+            optional(:allow_force_pushes).filled :bool
+            optional(:block_creations).filled :bool
+            optional(:required_conversation_resolution).filled :bool
+            optional(:required_linear_history).filled :bool
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ghub/endpoints/branches/protection/responses/show.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Ghub
+  module Endpoints
+    module Branches
+      module Protection
+        module Responses
+          # Defines a brnach protection response.
+          Show = Dry::Schema.Params do
+            required(:allow_deletions).hash { required(:enabled).filled :bool }
+            required(:allow_force_pushes).hash { required(:enabled).filled :bool }
+            required(:block_creations).hash { required(:enabled).filled :bool }
+            required(:enforce_admins).hash(Ghub::Responses::BooleanLink)
+            required(:required_conversation_resolution).hash { required(:enabled).filled :bool }
+            required(:required_linear_history).hash { required(:enabled).filled :bool }
+            required(:required_signatures).hash(Ghub::Responses::BooleanLink)
+            required(:required_status_checks).hash(Ghub::Responses::StatusCheck)
+            required(:url).filled :string
+
+            optional(:required_pull_request_reviews).hash(Ghub::Responses::Review)
+            optional(:restrictions).hash(Ghub::Responses::Restriction)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ghub/endpoints/branches/protection/root.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Ghub
+  module Endpoints
+    module Branches
+      module Protection
+        # Provides access to the branch protection API endpoint.
+        class Root
+          include Protection::Import[
+            :client,
+            show_action: "actions.show",
+            update_action: "actions.update"
+          ]
+
+          def show(...) = show_action.call(...)
+
+          def update(...) = update_action.call(...)
+
+          def destroy owner, repository, branch
+            client.delete "repos/#{owner}/#{repository}/branches/#{branch}/protection"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ghub/endpoints/branches/signature/container.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require "dry/container"
+
+module Ghub
+  module Endpoints
+    module Branches
+      module Signature
+        # Defines branch signature dependencies.
+        module Container
+          extend Dry::Container::Mixin
+
+          merge Ghub::Container
+
+          namespace :responses do
+            register(:show) { Ghub::Responses::BooleanLink }
+          end
+
+          namespace :models do
+            register(:show) { Ghub::Models::BooleanLink }
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ghub/endpoints/branches/signature/import.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require "infusible"
+
+module Ghub
+  module Endpoints
+    module Branches
+      module Signature
+        Import = Infusible.with Container
+      end
+    end
+  end
+end

data/lib/ghub/endpoints/branches/signature/root.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+require "transactable"
+
+module Ghub
+  module Endpoints
+    module Branches
+      module Signature
+        # Provides access to the branch signature API endpoint.
+        class Root
+          include Signature::Import[:client, response: "responses.show", model: "models.show"]
+          include Transactable
+
+          PATH = "repos/%{owner}/%{repository}/branches/%{branch}/protection/required_signatures"
+
+          def initialize path: PATH, **dependencies
+            super(**dependencies)
+            @path = path
+          end
+
+          def show owner, repository, branch
+            pipe format(path, owner:, repository:, branch:),
+                 to(client, :get),
+                 try(:parse, catch: JSON::ParserError),
+                 validate(response),
+                 to(model, :new)
+          end
+
+          def create owner, repository, branch
+            pipe format(path, owner:, repository:, branch:),
+                 to(client, :post),
+                 try(:parse, catch: JSON::ParserError),
+                 validate(response),
+                 to(model, :new)
+          end
+
+          def destroy owner, repository, branch
+            client.delete format(path, owner:, repository:, branch:)
+          end
+
+          private
+
+          attr_reader :path
+        end
+      end
+    end
+  end
+end

data/lib/ghub/endpoints/container.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+require "dry/container"
+
+module Ghub
+  module Endpoints
+    # Defines endpoint dependencies.
+    module Container
+      extend Dry::Container::Mixin
+
+      register(:branch_protection) { Endpoints::Branches::Protection::Root.new }
+      register(:branch_signature) { Endpoints::Branches::Signature::Root.new }
+      register(:organization_members) { Endpoints::Organizations::Members::Root.new }
+      register(:pulls) { Endpoints::Pulls::Root.new }
+      register(:repositories) { Endpoints::Repositories::Root.new }
+      register(:users) { Endpoints::Users::Root.new }
+    end
+  end
+end

data/lib/ghub/endpoints/import.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require "infusible"
+
+module Ghub
+  module Endpoints
+    Import = Infusible.with Container
+  end
+end

data/lib/ghub/endpoints/organizations/members/actions/index.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require "transactable"
+
+module Ghub
+  module Endpoints
+    module Organizations
+      module Members
+        module Actions
+          # Handles an organization member index action.
+          class Index
+            include Members::Import[:client, response: "responses.index", model: "models.show"]
+            include Transactable
+
+            def call owner, **parameters
+              pipe(
+                "orgs/#{owner}/members",
+                insert(parameters),
+                to(client, :get),
+                try(:parse, catch: JSON::ParserError),
+                fmap { |body| {body:} },
+                validate(response),
+                as(:fetch, :body),
+                map { |item| model.new item }
+              )
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ghub/endpoints/organizations/members/container.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require "dry/container"
+
+module Ghub
+  module Endpoints
+    module Organizations
+      module Members
+        # Defines member dependencies.
+        module Container
+          extend Dry::Container::Mixin
+
+          merge Ghub::Container
+
+          namespace :responses do
+            register(:index) { Responses::Index }
+          end
+
+          namespace :models do
+            register(:show) { Ghub::Models::User }
+          end
+
+          namespace :actions do
+            register(:index) { Actions::Index.new }
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ghub/endpoints/organizations/members/import.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require "infusible"
+
+module Ghub
+  module Endpoints
+    module Organizations
+      module Members
+        Import = Infusible.with Container
+      end
+    end
+  end
+end

data/lib/ghub/endpoints/organizations/members/responses/index.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Ghub
+  module Endpoints
+    module Organizations
+      module Members
+        module Responses
+          # Defines a collection of members.
+          Index = Dry::Schema.Params { required(:body).array :hash, Ghub::Responses::User }
+        end
+      end
+    end
+  end
+end

data/lib/ghub/endpoints/organizations/members/root.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Ghub
+  module Endpoints
+    module Organizations
+      module Members
+        # Provides access to the organization members API endpoint.
+        class Root
+          include Members::Import[index_action: "actions.index"]
+
+          def index(...) = index_action.call(...)
+        end
+      end
+    end
+  end
+end

data/lib/ghub/endpoints/pulls/actions/index.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require "transactable"
+
+module Ghub
+  module Endpoints
+    module Pulls
+      module Actions
+        # Handles a repository index action.
+        class Index
+          include Pulls::Import[:client, response: "responses.index", model: "models.show"]
+          include Transactable
+
+          def call owner, repository, **parameters
+            pipe(
+              client.get("repos/#{owner}/#{repository}/pulls", **parameters),
+              try(:parse, catch: JSON::ParserError),
+              fmap { |body| {body:} },
+              validate(response),
+              as(:fetch, :body),
+              map { |item| model.for item }
+            )
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ghub/endpoints/pulls/actions/show.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require "transactable"
+
+module Ghub
+  module Endpoints
+    module Pulls
+      module Actions
+        # Handles a repository index action.
+        class Show
+          include Pulls::Import[:client, response: "responses.show", model: "models.show"]
+          include Transactable
+
+          def call owner, repository, id, **parameters
+            pipe(
+              client.get("repos/#{owner}/#{repository}/pulls/#{id}", **parameters),
+              try(:parse, catch: JSON::ParserError),
+              validate(response),
+              to(model, :for)
+            )
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ghub/endpoints/pulls/container.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require "dry/container"
+
+module Ghub
+  module Endpoints
+    module Pulls
+      # Defines pull request dependencies.
+      module Container
+        extend Dry::Container::Mixin
+
+        merge Ghub::Container
+
+        namespace :responses do
+          register(:index) { Responses::Index }
+          register(:show) { Responses::Show }
+        end
+
+        namespace :models do
+          register(:show) { Models::Show }
+        end
+
+        namespace :actions do
+          register(:index) { Actions::Index.new }
+          register(:show) { Actions::Show.new }
+        end
+      end
+    end
+  end
+end

data/lib/ghub/endpoints/pulls/import.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require "infusible"
+
+module Ghub
+  module Endpoints
+    module Pulls
+      Import = Infusible.with Container
+    end
+  end
+end

data/lib/ghub/endpoints/pulls/models/show.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+module Ghub
+  module Endpoints
+    module Pulls
+      module Models
+        # Defines a single pull request.
+        Show = Struct.new(
+          :_links,
+          :active_lock_reason,
+          :additions,
+          :assignee,
+          :assignees,
+          :author_association,
+          :auto_merge,
+          :base,
+          :body,
+          :changed_files,
+          :closed_at,
+          :comments,
+          :comments_url,
+          :commits,
+          :commits_url,
+          :created_at,
+          :deletions,
+          :diff_url,
+          :draft,
+          :head,
+          :html_url,
+          :id,
+          :issue_url,
+          :labels,
+          :locked,
+          :maintainer_can_modify,
+          :mergable,
+          :merge_commit_sha,
+          :mergeable_state,
+          :merged,
+          :merged_at,
+          :merged_by,
+          :milestone,
+          :node_id,
+          :number,
+          :patch_url,
+          :rebaseable,
+          :requested_reviewers,
+          :requested_teams,
+          :review_comment_url,
+          :review_comments,
+          :review_comments_url,
+          :state,
+          :statuses_url,
+          :title,
+          :updated_at,
+          :url,
+          :user,
+          keyword_init: true
+        ) do
+          include Resultable
+
+          def self.for attributes
+            new attributes.merge(
+              _links: Ghub::Models::Links.for(attributes[:_links]),
+              assignee: Ghub::Models::User[attributes[:assignee]],
+              assignees: attributes[:assignees].map { |data| Ghub::Models::User[data] },
+              base: Ghub::Models::Branch[attributes[:base]],
+              head: Ghub::Models::Branch[attributes[:head]],
+              labels: attributes[:labels].map { |data| Ghub::Models::Label[data] },
+              user: Ghub::Models::User[attributes[:user]]
+            )
+          end
+
+          def initialize *arguments
+            super
+            freeze
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ghub/endpoints/pulls/responses/index.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Ghub
+  module Endpoints
+    module Pulls
+      module Responses
+        # Defines a collection of pull requests.
+        Index = Dry::Schema.Params { required(:body).array :hash, Show }
+      end
+    end
+  end
+end