ghub 0.0.0 → 2.3.0

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

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require "pipeable"
+
+module Ghub
+  module Endpoints
+    module Search
+      module Users
+        module Actions
+          # Handles a user index action.
+          class Index
+            include Ghub::Dependencies[:api]
+            include Dependencies[response: "responses.index", model: "models.index"]
+            include Pipeable
+
+            def call **parameters
+              pipe(
+                api.get("search/users", **parameters),
+                try(:parse, catch: JSON::ParserError),
+                validate(response, as: :to_h),
+                as(:fetch, :items),
+                map { |item| model.for(**item) }
+              )
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require "containable"
+
+module Ghub
+  module Endpoints
+    module Search
+      module Users
+        # Defines user dependencies.
+        module Container
+          extend Containable
+
+          namespace :responses do
+            register :index, Responses::Index
+          end
+
+          namespace :models do
+            register :index, Models::Index
+          end
+
+          namespace :actions do
+            register(:index) { Actions::Index.new }
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ghub/endpoints/search/users/dependencies.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require "infusible"
+
+module Ghub
+  module Endpoints
+    module Search
+      module Users
+        Dependencies = Infusible[Container]
+      end
+    end
+  end
+end

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

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Ghub
+  module Endpoints
+    module Search
+      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,
+            :score,
+            :site_admin,
+            :starred_url,
+            :subscriptions_url,
+            :type,
+            :url
+          ) do
+            def self.for(**) = new(**)
+
+            def initialize(**)
+              super
+              freeze
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ghub/endpoints/search/users/responses/index.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module Ghub
+  module Endpoints
+    module Search
+      module Users
+        module Responses
+          # Defines a user within a collection.
+          Index = Dry::Schema.Params do
+            required(:total_count).filled :integer
+            required(:incomplete_results).filled :bool
+            required(:items).array(:hash) do
+              required(:avatar_url).filled :string
+              required(:events_url).filled :string
+              required(:followers_url).filled :string
+              required(:following_url).filled :string
+              required(:gists_url).filled :string
+              required(:gravatar_id).maybe :string
+              required(:html_url).filled :string
+              required(:id).filled :integer
+              required(:login).filled :string
+              required(:node_id).filled :string
+              required(:organizations_url).filled :string
+              required(:received_events_url).filled :string
+              required(:repos_url).filled :string
+              required(:score).filled :float
+              required(:site_admin).filled :bool
+              required(:starred_url).filled :string
+              required(:subscriptions_url).filled :string
+              required(:type).filled :string
+              required(:url).filled :string
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ghub/endpoints/search/users/root.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Ghub
+  module Endpoints
+    module Search
+      module Users
+        # Provides access to the search API endpoint for users.
+        class Root
+          include Dependencies[index_action: "actions.index"]
+
+          def index(...) = index_action.call(...)
+        end
+      end
+    end
+  end
+end

data/lib/ghub/endpoints/users/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 user index action.
         class Index
-          include Users::Import[:client, response: "responses.index", model: "models.index"]
-          include Transactable
+          include Ghub::Dependencies[:api]
+          include Dependencies[response: "responses.index", model: "models.index"]
+          include Pipeable
 
           def call **parameters
             pipe(
-              client.get("users", **parameters),
+              api.get("users", **parameters),
               try(:parse, catch: JSON::ParserError),
               fmap { |body| {body:} },
-              validate(response),
+              validate(response, as: :to_h),
               as(:fetch, :body),
-              map { |item| model.new item.to_h }
+              map { |item| model.for(**item) }
             )
           end
         end

data/lib/ghub/endpoints/users/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 user show action.
         class Show
-          include Users::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 id, **parameters
-            pipe client.get("users/#{id}", **parameters),
+            pipe api.get("users/#{id}", **parameters),
                  try(:parse, catch: JSON::ParserError),
-                 validate(response),
-                 to(model, :new)
+                 validate(response, as: :to_h),
+                 to(model, :for)
           end
         end
       end

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

@@ -1,24 +1,22 @@
 # frozen_string_literal: true
 
-require "dry/container"
+require "containable"
 
 module Ghub
   module Endpoints
     module Users
       # Defines user 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(:index) { Models::Index }
-          register(:show) { Models::Show }
+          register :index, Models::Index
+          register :show,  Models::Show
         end
 
         namespace :actions do

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

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

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

@@ -23,12 +23,11 @@ module Ghub
           :starred_url,
           :subscriptions_url,
           :type,
-          :url,
-          keyword_init: true
+          :url
         ) do
-          include Resultable
+          def self.for(**) = new(**)
 
-          def initialize *arguments
+          def initialize(**)
             super
             freeze
           end

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

@@ -37,12 +37,11 @@ module Ghub
           :twitter_username,
           :type,
           :updated_at,
-          :url,
-          keyword_init: true
+          :url
         ) do
-          include Resultable
+          def self.for(**) = new(**)
 
-          def initialize *arguments
+          def initialize(**)
             super
             freeze
           end

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

@@ -5,7 +5,7 @@ module Ghub
     module Users
       # Provides access to the users API endpoint.
       class Root
-        include Users::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/models/application.rb

@@ -15,17 +15,18 @@ module Ghub
       :owner,
       :permissions,
       :slug,
-      :updated_at,
-      keyword_init: true
+      :updated_at
     ) do
-      def self.for attributes
-        new attributes.merge(
-          owner: Owner[attributes[:owner]],
-          permissions: Permissions::Branch[attributes[:permissions]]
+      def self.for **attributes
+        new(
+          **attributes.merge!(
+            owner: Owner[**attributes[:owner]],
+            permissions: Permissions::Branch[**attributes[:permissions]]
+          )
         )
       end
 
-      def initialize *arguments
+      def initialize(**)
         super
         freeze
       end

data/lib/ghub/models/boolean_link.rb

@@ -3,8 +3,10 @@
 module Ghub
   module Models
     # Defines a boolean link.
-    BooleanLink = Struct.new :enabled, :url, keyword_init: true do
-      def initialize *arguments
+    BooleanLink = Struct.new :enabled, :url do
+      def self.for(**) = new(**)
+
+      def initialize(**)
         super
         freeze
       end

data/lib/ghub/models/branch.rb

@@ -3,15 +3,17 @@
 module Ghub
   module Models
     # Defines a branch.
-    Branch = Struct.new :label, :ref, :repo, :sha, :user, keyword_init: true do
-      def self.for attributes
-        new attributes.merge(
-          user: User[attributes[:user]],
-          repo: Repository.for(attributes[:repo])
+    Branch = Struct.new :label, :ref, :repo, :sha, :user do
+      def self.for **attributes
+        new(
+          **attributes.merge!(
+            user: User[**attributes[:user]],
+            repo: Repository.for(**attributes[:repo])
+          )
         )
       end
 
-      def initialize *arguments
+      def initialize(**)
         super
         freeze
       end

data/lib/ghub/models/check.rb

@@ -3,12 +3,8 @@
 module Ghub
   module Models
     # Defines a check.
-    Check = Struct.new(
-      :context,
-      :app_id,
-      keyword_init: true
-    ) do
-      def initialize *arguments
+    Check = Struct.new :context, :app_id do
+      def initialize(**)
         super
         freeze
       end

data/lib/ghub/models/dismissal_restriction.rb

@@ -9,20 +9,21 @@ module Ghub
       :teams_url,
       :url,
       :users,
-      :users_url,
-      keyword_init: true
+      :users_url
     ) do
-      def self.for attributes
-        return new unless attributes
+      def self.for **attributes
+        return new if attributes.empty?
 
-        new attributes.merge(
-          apps: attributes[:apps].map { |arguments| Application[arguments] },
-          teams: attributes[:teams].map { |arguments| Team[arguments] },
-          users: attributes[:users].map { |arguments| User[arguments] }
+        new(
+          **attributes.merge!(
+            apps: attributes[:apps].map { |arguments| Application[**arguments] },
+            teams: attributes[:teams].map { |arguments| Team[**arguments] },
+            users: attributes[:users].map { |arguments| User[**arguments] }
+          )
         )
       end
 
-      def initialize *arguments
+      def initialize(**)
         super
         freeze
       end

data/lib/ghub/models/label.rb

@@ -10,10 +10,9 @@ module Ghub
       :id,
       :name,
       :node_id,
-      :url,
-      keyword_init: true
+      :url
     ) do
-      def initialize *arguments
+      def initialize(**)
         super
         freeze
       end

data/lib/ghub/models/license.rb

@@ -8,10 +8,9 @@ module Ghub
       :name,
       :node_id,
       :spdx_id,
-      :url,
-      keyword_init: true
+      :url
     ) do
-      def initialize *arguments
+      def initialize(**)
         super
         freeze
       end

data/lib/ghub/models/link.rb

@@ -3,8 +3,8 @@
 module Ghub
   module Models
     # Defines a link.
-    Link = Struct.new :href, keyword_init: true do
-      def initialize *arguments
+    Link = Struct.new :href do
+      def initialize(**)
         super
         freeze
       end

data/lib/ghub/models/links.rb

@@ -11,15 +11,14 @@ module Ghub
       :review_comments,
       :review_comment,
       :commits,
-      :statuses,
-      keyword_init: true
+      :statuses
     ) do
-      def self.for attributes
-        attributes.reduce({}) { |collection, (key, value)| collection.merge key => Link[value] }
-                  .then { |updated_attributes| new updated_attributes }
+      def self.for **attributes
+        attributes.reduce({}) { |collection, (key, value)| collection.merge key => Link[**value] }
+                  .then { |updates| new(**updates) }
       end
 
-      def initialize *arguments
+      def initialize(**)
         super
         freeze
       end

data/lib/ghub/models/owner.rb

@@ -15,10 +15,9 @@ module Ghub
       :members_url,
       :public_members_url,
       :avatar_url,
-      :description,
-      keyword_init: true
+      :description
     ) do
-      def initialize *arguments
+      def initialize(**)
         super
         freeze
       end

data/lib/ghub/models/permissions/branch.rb

@@ -8,10 +8,9 @@ module Ghub
         :contents,
         :issues,
         :metadata,
-        :single_file,
-        keyword_init: true
+        :single_file
       ) do
-        def initialize *arguments
+        def initialize(**)
           super
           freeze
         end

data/lib/ghub/models/permissions/repository.rb

@@ -9,10 +9,9 @@ module Ghub
         :maintain,
         :pull,
         :push,
-        :triage,
-        keyword_init: true
+        :triage
       ) do
-        def initialize *arguments
+        def initialize(**)
           super
           freeze
         end

data/lib/ghub/models/repository.rb

@@ -86,26 +86,32 @@ module Ghub
       :watchers,
       :watchers_count,
       :web_commit_signoff_required,
-      :weight,
-      keyword_init: true
+      :weight
     ) do
-      include Resultable
-
-      def self.for attributes
-        new attributes.transform_keys(size: :weight).merge(
-          license: (License[Hash(attributes[:license])] if attributes.key? :license),
-          owner: User[attributes[:owner]],
-          organization: (User[attributes[:organization]] if attributes.key? :organization),
+      def self.for **attributes
+        new(
+          **attributes.transform_keys!(size: :weight),
+          license: (License[**Hash(attributes[:license])] if attributes.key? :license),
+          owner: User[**attributes[:owner]],
+          organization: (User[**attributes[:organization]] if attributes.key? :organization),
           permissions: (
-            Permissions::Repository[attributes[:permissions]] if attributes.key? :permissions
+            Permissions::Repository[**attributes[:permissions]] if attributes.key? :permissions
           )
         )
       end
 
-      def initialize *arguments
+      def initialize(**)
         super
         freeze
       end
+
+      def archived? = archived == true
+
+      def forked? = fork == true
+
+      def private? = private == true
+
+      def sharable? = !(archived? || forked? || private?)
     end
   end
 end

data/lib/ghub/models/restriction.rb

@@ -10,20 +10,21 @@ module Ghub
       :teams_url,
       :url,
       :users,
-      :users_url,
-      keyword_init: true
+      :users_url
     ) do
-      def self.for attributes
-        return new unless attributes
+      def self.for **attributes
+        return new if attributes.empty?
 
-        new attributes.merge(
-          apps: attributes[:apps].map { |arguments| Application[arguments] },
-          teams: attributes[:teams].map { |arguments| Team[arguments] },
-          users: attributes[:users].map { |arguments| User[arguments] }
+        new(
+          **attributes.merge!(
+            apps: attributes[:apps].map { |arguments| Application[**arguments] },
+            teams: attributes[:teams].map { |arguments| Team[**arguments] },
+            users: attributes[:users].map { |arguments| User[**arguments] }
+          )
         )
       end
 
-      def initialize *arguments
+      def initialize(**)
         super
         freeze
       end

data/lib/ghub/models/review.rb

@@ -8,18 +8,19 @@ module Ghub
       :require_code_owner_reviews,
       :required_approving_review_count,
       :url,
-      :dismissal_restrictions,
-      keyword_init: true
+      :dismissal_restrictions
     ) do
-      def self.for attributes
-        return new unless attributes
+      def self.for **attributes
+        return new if attributes.empty?
 
-        new attributes.merge(
-          dismissal_restrictions: DismissalRestriction.for(attributes[:dismissal_restrictions])
+        new(
+          **attributes.merge!(
+            dismissal_restrictions: DismissalRestriction.for(**attributes[:dismissal_restrictions])
+          )
         )
       end
 
-      def initialize *arguments
+      def initialize(**)
         super
         freeze
       end

data/lib/ghub/models/status_check.rb

@@ -9,14 +9,15 @@ module Ghub
       :contexts,
       :contexts_url,
       :checks,
-      :enforcement_level,
-      keyword_init: true
+      :enforcement_level
     ) do
-      def self.for attributes
-        new attributes.merge(checks: attributes[:checks].map { |arguments| Check[arguments] })
+      def self.for **attributes
+        new(
+          **attributes.merge!(checks: attributes[:checks].map { |arguments| Check[**arguments] })
+        )
       end
 
-      def initialize *arguments
+      def initialize(**)
         super
         freeze
       end