ghub 0.0.0 → 2.3.0

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

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

data/lib/ghub/endpoints/container.rb

@@ -1,18 +1,19 @@
 # frozen_string_literal: true
 
-require "dry/container"
+require "containable"
 
 module Ghub
   module Endpoints
     # Defines endpoint dependencies.
     module Container
-      extend Dry::Container::Mixin
+      extend Containable
 
       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(:search_users) { Endpoints::Search::Users::Root.new }
       register(:users) { Endpoints::Users::Root.new }
     end
   end

data/lib/ghub/endpoints/{import.rb → dependencies.rb}

@@ -4,6 +4,6 @@ require "infusible"
 
 module Ghub
   module Endpoints
-    Import = Infusible.with Container
+    Dependencies = Infusible[Container]
   end
 end

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

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

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

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

data/lib/ghub/endpoints/organizations/members/{import.rb → dependencies.rb}

@@ -6,7 +6,7 @@ module Ghub
   module Endpoints
     module Organizations
       module Members
-        Import = Infusible.with Container
+        Dependencies = Infusible[Container]
       end
     end
   end

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

@@ -6,7 +6,7 @@ module Ghub
       module Members
         # Provides access to the organization members API endpoint.
         class Root
-          include Members::Import[index_action: "actions.index"]
+          include Dependencies[index_action: "actions.index"]
 
           def index(...) = index_action.call(...)
         end

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

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

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

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

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

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

data/lib/ghub/endpoints/pulls/{import.rb → dependencies.rb}

@@ -5,7 +5,7 @@ require "infusible"
 module Ghub
   module Endpoints
     module Pulls
-      Import = Infusible.with Container
+      Dependencies = Infusible[Container]
     end
   end
 end

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

@@ -32,7 +32,7 @@ module Ghub
           :labels,
           :locked,
           :maintainer_can_modify,
-          :mergable,
+          :mergeable,
           :merge_commit_sha,
           :mergeable_state,
           :merged,
@@ -53,24 +53,25 @@ module Ghub
           :title,
           :updated_at,
           :url,
-          :user,
-          keyword_init: true
+          :user
         ) do
-          include Resultable
+          def self.for **attributes
+            assignee = attributes[:assignee]
 
-          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]]
+            new(
+              **attributes.merge!(
+                _links: Ghub::Models::Links.for(**attributes[:_links]),
+                assignee: (Ghub::Models::User[**assignee] if 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
+          def initialize(**)
             super
             freeze
           end

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

@@ -6,13 +6,13 @@ module Ghub
       module Responses
         # Defines a single pull request.
         Show = Dry::Schema.Params do
-          required(:_links).hash(Ghub::Responses::Links)
+          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(:assignee).maybe :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(:base).hash Ghub::Responses::Branch
           required(:body).filled :string
           required(:closed_at).filled :string
           required(:comments_url).filled :string
@@ -20,11 +20,11 @@ module Ghub
           required(:created_at).filled :string
           required(:diff_url).filled :string
           required(:draft).filled :bool
-          required(:head).hash(Ghub::Responses::Branch)
+          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(:labels).array Ghub::Responses::Label
           required(:locked).filled :bool
           required(:merge_commit_sha).filled :string
           required(:merged_at).maybe :date_time
@@ -41,7 +41,7 @@ module Ghub
           required(:title).filled :string
           required(:updated_at).filled :string
           required(:url).filled :string
-          required(:user).hash(Ghub::Responses::User)
+          required(:user).hash Ghub::Responses::User
 
           optional(:additions).filled :integer
           optional(:changed_files).filled :integer

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

@@ -5,7 +5,7 @@ module Ghub
     module Pulls
       # Provides access to the pulls API endpoint.
       class Root
-        include Pulls::Import[index_action: "actions.index", show_action: "actions.show"]
+        include Dependencies[index_action: "actions.index", show_action: "actions.show"]
 
         def index(...) = index_action.call(...)
 

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

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require "transactable"
+require "pipeable"
 
 module Ghub
   module Endpoints
@@ -8,27 +8,28 @@ module Ghub
       module Actions
         # Handles a repository create action.
         class Create
-          include Import[
-            :client,
+          include Ghub::Dependencies[:api]
+
+          include Dependencies[
             :path,
             request: "requests.create",
             response: "responses.show",
             model: "models.show"
           ]
 
-          include Transactable
+          include Pipeable
 
           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
+            path.create(kind, owner:).bind do |url_path|
+              pipe body,
+                   validate(request),
+                   insert(url_path, at: 0),
+                   insert(parameters),
+                   to(api, :post),
+                   try(:parse, catch: JSON::ParserError),
+                   validate(response, as: :to_h),
+                   to(model, :for)
+            end
           end
         end
       end

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

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require "transactable"
+require "pipeable"
 
 module Ghub
   module Endpoints
@@ -8,25 +8,20 @@ module Ghub
       module Actions
         # Handles a repository index action.
         class Index
-          include Repositories::Import[
-            :client,
-            :path,
-            response: "responses.index",
-            model: "models.show"
-          ]
-
-          include Transactable
+          include Ghub::Dependencies[:api]
+          include Dependencies[:path, response: "responses.index", model: "models.show"]
+          include Pipeable
 
           def call kind, owner, **parameters
             pipe(
               path.index(kind, owner),
               insert(parameters),
-              to(client, :get),
+              to(api, :get),
               try(:parse, catch: JSON::ParserError),
               fmap { |body| {body:} },
-              validate(response),
+              validate(response, as: :to_h),
               as(:fetch, :body),
-              map { |item| model.for item }
+              map { |item| model.for(**item) }
             )
           end
         end

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

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require "transactable"
+require "pipeable"
 
 module Ghub
   module Endpoints
@@ -8,27 +8,28 @@ module Ghub
       module Actions
         # Handles a repository patch action.
         class Patch
-          include Import[
-            :client,
+          include Ghub::Dependencies[:api]
+
+          include Dependencies[
             :path,
             request: "requests.patch",
             response: "responses.show",
             model: "models.show"
           ]
 
-          include Transactable
+          include Pipeable
 
           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
+            path.patch(owner, id).bind do |url_path|
+              pipe body,
+                   validate(request),
+                   insert(url_path, at: 0),
+                   insert(parameters),
+                   to(api, :patch),
+                   try(:parse, catch: JSON::ParserError),
+                   validate(response, as: :to_h),
+                   to(model, :for)
+            end
           end
         end
       end

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

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

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

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

data/lib/ghub/endpoints/repositories/{import.rb → dependencies.rb}

@@ -5,7 +5,7 @@ require "infusible"
 module Ghub
   module Endpoints
     module Repositories
-      Import = Infusible.with Container
+      Dependencies = Infusible[Container]
     end
   end
 end

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

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 require "dry/monads"
-require "refinements/arrays"
+require "refinements/array"
 
 module Ghub
   module Endpoints
@@ -10,7 +10,7 @@ module Ghub
       class Path
         include Dry::Monads[:result]
 
-        using Refinements::Arrays
+        using Refinements::Array
 
         KINDS = %w[users orgs].freeze
 
@@ -43,11 +43,7 @@ module Ghub
 
         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
+        def error(kind) = Failure %(Invalid kind: #{kind.inspect}. Use: #{kinds.to_usage "or"}.)
       end
     end
   end

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

@@ -5,8 +5,9 @@ module Ghub
     module Repositories
       # Provides access to the users API endpoint.
       class Root
-        include Repositories::Import[
-          :client,
+        include Ghub::Dependencies[:api]
+
+        include Dependencies[
           create_action: "actions.create",
           index_action: "actions.index",
           patch_action: "actions.patch",
@@ -21,7 +22,7 @@ module Ghub
 
         def patch(...) = patch_action.call(...)
 
-        def destroy(owner, id) = client.delete "repos/#{owner}/#{id}"
+        def destroy(owner, id) = api.delete "repos/#{owner}/#{id}"
       end
     end
   end