ghub 0.0.0

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

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+module Ghub
+  module Endpoints
+    module Pulls
+      module Responses
+        # Defines a single pull request.
+        Show = Dry::Schema.Params do
+          required(:_links).hash(Ghub::Responses::Links)
+          required(:active_lock_reason).maybe :string
+          required(:assignee).hash(Ghub::Responses::User)
+          required(:assignees).array(Ghub::Responses::User)
+          required(:author_association).filled :string
+          required(:auto_merge).maybe :bool
+          required(:base).hash(Ghub::Responses::Branch)
+          required(:body).filled :string
+          required(:closed_at).filled :string
+          required(:comments_url).filled :string
+          required(:commits_url).filled :string
+          required(:created_at).filled :string
+          required(:diff_url).filled :string
+          required(:draft).filled :bool
+          required(:head).hash(Ghub::Responses::Branch)
+          required(:html_url).filled :string
+          required(:id).filled :integer
+          required(:issue_url).filled :string
+          required(:labels).array(Ghub::Responses::Label)
+          required(:locked).filled :bool
+          required(:merge_commit_sha).filled :string
+          required(:merged_at).maybe :date_time
+          required(:milestone).maybe :hash
+          required(:node_id).filled :string
+          required(:number).filled :integer
+          required(:patch_url).filled :string
+          required(:requested_reviewers).maybe :array
+          required(:requested_teams).maybe :array
+          required(:review_comment_url).filled :string
+          required(:review_comments_url).filled :string
+          required(:state).filled :string
+          required(:statuses_url).filled :string
+          required(:title).filled :string
+          required(:updated_at).filled :string
+          required(:url).filled :string
+          required(:user).hash(Ghub::Responses::User)
+
+          optional(:additions).filled :integer
+          optional(:changed_files).filled :integer
+          optional(:comments).filled :integer
+          optional(:commits).filled :integer
+          optional(:deletions).filled :integer
+          optional(:maintainer_can_modify).filled :bool
+          optional(:mergable).filled :bool
+          optional(:mergeable_state).filled :string
+          optional(:merged).filled :bool
+          optional(:merged_by).maybe :string
+          optional(:rebaseable).filled :bool
+          optional(:review_comments).filled :integer
+        end
+      end
+    end
+  end
+end

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

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

data/lib/ghub/endpoints/repositories/actions/create.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require "transactable"
+
+module Ghub
+  module Endpoints
+    module Repositories
+      module Actions
+        # Handles a repository create action.
+        class Create
+          include Import[
+            :client,
+            :path,
+            request: "requests.create",
+            response: "responses.show",
+            model: "models.show"
+          ]
+
+          include Transactable
+
+          def call kind, body, owner: nil, **parameters
+            path.create(kind, owner:)
+                .bind do |url_path|
+                  pipe body,
+                       validate(request),
+                       insert(url_path, parameters, at: 0),
+                       to(client, :post),
+                       try(:parse, catch: JSON::ParserError),
+                       validate(response),
+                       to(model, :for)
+                end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require "transactable"
+
+module Ghub
+  module Endpoints
+    module Repositories
+      module Actions
+        # Handles a repository index action.
+        class Index
+          include Repositories::Import[
+            :client,
+            :path,
+            response: "responses.index",
+            model: "models.show"
+          ]
+
+          include Transactable
+
+          def call kind, owner, **parameters
+            pipe(
+              path.index(kind, owner),
+              insert(parameters),
+              to(client, :get),
+              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/repositories/actions/patch.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require "transactable"
+
+module Ghub
+  module Endpoints
+    module Repositories
+      module Actions
+        # Handles a repository patch action.
+        class Patch
+          include Import[
+            :client,
+            :path,
+            request: "requests.patch",
+            response: "responses.show",
+            model: "models.show"
+          ]
+
+          include Transactable
+
+          def call owner, id, body, **parameters
+            path.patch(owner, id)
+                .bind do |url_path|
+                  pipe body,
+                       validate(request),
+                       insert(url_path, parameters, at: 0),
+                       to(client, :patch),
+                       try(:parse, catch: JSON::ParserError),
+                       validate(response),
+                       to(model, :for)
+                end
+          end
+        end
+      end
+    end
+  end
+end

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

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

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

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require "dry/container"
+
+module Ghub
+  module Endpoints
+    module Repositories
+      # Defines repository dependencies.
+      module Container
+        extend Dry::Container::Mixin
+
+        merge Ghub::Container
+
+        namespace :requests do
+          register(:create) { Requests::Create }
+          register(:patch) { Requests::Patch }
+        end
+
+        namespace :responses do
+          register(:index) { Responses::Index }
+          register(:show) { Ghub::Responses::Repository }
+        end
+
+        namespace :models do
+          register(:show) { Ghub::Models::Repository }
+        end
+
+        register(:path) { Path.new }
+
+        namespace :actions do
+          register(:create) { Actions::Create.new }
+          register(:index) { Actions::Index.new }
+          register(:patch) { Actions::Patch.new }
+          register(:show) { Actions::Show.new }
+        end
+      end
+    end
+  end
+end

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

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

data/lib/ghub/endpoints/repositories/path.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+require "dry/monads"
+require "refinements/arrays"
+
+module Ghub
+  module Endpoints
+    module Repositories
+      # Dynamically builds API repository path sfor users or organizations.
+      class Path
+        include Dry::Monads[:result]
+
+        using Refinements::Arrays
+
+        KINDS = %w[users orgs].freeze
+
+        def initialize kinds: KINDS
+          @kinds = kinds
+        end
+
+        def index kind, owner
+          kinds.include?(kind.to_s) ? Success("#{kind}/#{owner}/repos") : error(kind)
+        end
+
+        def show(...) = resource(...)
+
+        def create kind, owner: nil
+          case kind.to_s
+            when "users" then Success "user/repos"
+            when "orgs"
+              owner ? Success("orgs/#{owner}/repos") : Failure("Organization name is missing.")
+            else error kind
+          end
+        end
+
+        def patch(...) = resource(...)
+
+        def destroy(...) = resource(...)
+
+        private
+
+        attr_reader :kinds
+
+        def resource(owner, id) = Success "repos/#{owner}/#{id}"
+
+        def error kind
+          kinds.map(&:inspect)
+               .to_sentence(conjunction: "or")
+               .then { |choices| Failure "Invalid kind: #{kind.inspect}. Use: #{choices}." }
+        end
+      end
+    end
+  end
+end

data/lib/ghub/endpoints/repositories/requests/create.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Ghub
+  module Endpoints
+    module Repositories
+      module Requests
+        # Defines the data structure for creating a repository.
+        Create = Dry::Schema.JSON do
+          required(:name).filled :string
+
+          optional(:allow_auto_merge).filled :bool
+          optional(:allow_merge_commit).filled :bool
+          optional(:allow_rebase_merge).filled :bool
+          optional(:allow_squash_merge).filled :bool
+          optional(:auto_init).filled :bool
+          optional(:delete_branch_on_merge).filled :bool
+          optional(:description).filled :string
+          optional(:gitignore_template).filled :string
+          optional(:has_downloads).filled :bool
+          optional(:has_issues).filled :bool
+          optional(:has_projects).filled :bool
+          optional(:has_wiki).filled :bool
+          optional(:homepage).filled :string
+          optional(:is_template).filled :bool
+          optional(:license_template).filled :string
+          optional(:private).filled :bool
+          optional(:team_id).filled :integer
+        end
+      end
+    end
+  end
+end

data/lib/ghub/endpoints/repositories/requests/patch.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module Ghub
+  module Endpoints
+    module Repositories
+      module Requests
+        # Defines the data structure for patching a repository.
+        Patch = Dry::Schema.JSON do
+          optional(:allow_auto_merge).filled :bool
+          optional(:allow_forking).filled :bool
+          optional(:allow_merge_commit).filled :bool
+          optional(:allow_rebase_merge).filled :bool
+          optional(:allow_squash_merge).filled :bool
+          optional(:archived).filled :bool
+          optional(:default_branch).filled :string
+          optional(:delete_branch_on_merge).filled :bool
+          optional(:description).filled :string
+          optional(:has_issues).filled :bool
+          optional(:has_projects).filled :bool
+          optional(:has_wiki).filled :bool
+          optional(:homepage).filled :string
+          optional(:is_template).filled :bool
+          optional(:name).filled :string
+          optional(:private).filled :bool
+
+          optional(:security_and_analysis).hash do
+            optional(:advanced_security).hash { required(:status).filled :string }
+            optional(:secret_scanning).hash { required(:status).filled :string }
+            optional(:secret_scanning_push_protection).hash { required(:status).filled :string }
+          end
+
+          optional(:use_squash_pr_title_as_default).filled :bool
+          optional(:visibility).filled :bool
+        end
+      end
+    end
+  end
+end

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

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

data/lib/ghub/endpoints/repositories/responses/show.rb

@@ -0,0 +1,97 @@
+# frozen_string_literal: true
+
+module Ghub
+  module Endpoints
+    module Repositories
+      module Responses
+        # Defines a repository.
+        Show = Dry::Schema.Params do
+          required(:allow_forking).filled :bool
+          required(:archive_url).filled :string
+          required(:archived).filled :bool
+          required(:assignees_url).filled :string
+          required(:blobs_url).filled :string
+          required(:branches_url).filled :string
+          required(:clone_url).filled :string
+          required(:collaborators_url).filled :string
+          required(:comments_url).filled :string
+          required(:commits_url).filled :string
+          required(:compare_url).filled :string
+          required(:contents_url).filled :string
+          required(:contributors_url).filled :string
+          required(:created_at).filled :date_time
+          required(:default_branch).filled :string
+          required(:deployments_url).filled :string
+          required(:description).maybe :string
+          required(:disabled).filled :bool
+          required(:downloads_url).filled :string
+          required(:events_url).filled :string
+          required(:fork).filled :bool
+          required(:forks).filled :integer
+          required(:forks_count).filled :integer
+          required(:forks_url).filled :string
+          required(:full_name).filled :string
+          required(:git_commits_url).filled :string
+          required(:git_refs_url).filled :string
+          required(:git_tags_url).filled :string
+          required(:git_url).filled :string
+          required(:has_downloads).filled :bool
+          required(:has_issues).filled :bool
+          required(:has_pages).filled :bool
+          required(:has_projects).filled :bool
+          required(:has_wiki).filled :bool
+          required(:homepage).maybe :string
+          required(:hooks_url).filled :string
+          required(:html_url).filled :string
+          required(:id).filled :integer
+          required(:is_template).filled :bool
+          required(:issue_comment_url).filled :string
+          required(:issue_events_url).filled :string
+          required(:issues_url).filled :string
+          required(:keys_url).filled :string
+          required(:labels_url).filled :string
+          required(:language).maybe :string
+          required(:languages_url).filled :string
+          required(:license).maybe :hash, Ghub::Responses::License
+          required(:merges_url).filled :string
+          required(:milestones_url).filled :string
+          required(:mirror_url).maybe :string
+          required(:name).filled :string
+          required(:node_id).filled :string
+          required(:notifications_url).filled :string
+          required(:open_issues).filled :integer
+          required(:open_issues_count).filled :integer
+          required(:owner).hash Ghub::Responses::User
+          required(:private).filled :bool
+          required(:pulls_url).filled :string
+          required(:pushed_at).filled :date_time
+          required(:releases_url).filled :string
+          required(:size).filled :integer
+          required(:ssh_url).filled :string
+          required(:stargazers_count).filled :integer
+          required(:stargazers_url).filled :string
+          required(:statuses_url).filled :string
+          required(:subscribers_url).filled :string
+          required(:subscription_url).filled :string
+          required(:svn_url).filled :string
+          required(:tags_url).filled :string
+          required(:teams_url).filled :string
+          required(:topics).array(:str?)
+          required(:trees_url).filled :string
+          required(:updated_at).filled :date_time
+          required(:url).filled :string
+          required(:visibility).filled :string
+          required(:watchers).filled :integer
+          required(:watchers_count).filled :integer
+          required(:web_commit_signoff_required).filled :bool
+
+          optional(:network_count).filled :integer
+          optional(:organization).hash Ghub::Responses::User
+          optional(:permissions).hash Ghub::Responses::Permission
+          optional(:subscribers_count).filled :integer
+          optional(:temp_clone_token).maybe :string
+        end
+      end
+    end
+  end
+end

data/lib/ghub/endpoints/repositories/root.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Ghub
+  module Endpoints
+    module Repositories
+      # Provides access to the users API endpoint.
+      class Root
+        include Repositories::Import[
+          :client,
+          create_action: "actions.create",
+          index_action: "actions.index",
+          patch_action: "actions.patch",
+          show_action: "actions.show"
+        ]
+
+        def index(...) = index_action.call(...)
+
+        def show(...) = show_action.call(...)
+
+        def create(...) = create_action.call(...)
+
+        def patch(...) = patch_action.call(...)
+
+        def destroy(owner, id) = client.delete "repos/#{owner}/#{id}"
+      end
+    end
+  end
+end

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

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

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

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

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

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require "dry/container"
+
+module Ghub
+  module Endpoints
+    module Users
+      # Defines user 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(:index) { Models::Index }
+          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/users/import.rb

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

data/lib/ghub/endpoints/users/models/index.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Ghub
+  module Endpoints
+    module Users
+      module Models
+        # Defines a user within a collection.
+        Index = Struct.new(
+          :avatar_url,
+          :events_url,
+          :followers_url,
+          :following_url,
+          :gists_url,
+          :gravatar_id,
+          :html_url,
+          :id,
+          :login,
+          :node_id,
+          :organizations_url,
+          :received_events_url,
+          :repos_url,
+          :site_admin,
+          :starred_url,
+          :subscriptions_url,
+          :type,
+          :url,
+          keyword_init: true
+        ) do
+          include Resultable
+
+          def initialize *arguments
+            super
+            freeze
+          end
+        end
+      end
+    end
+  end
+end