gitea-client 1.5.0 → 1.5.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3834af0c17b279bc9664771bab2a2da7e96a86ee0cf28d95217cc639c3e516ff
-  data.tar.gz: e6e1a73e61ea258ad1b16a1d762668b50b5c55c53cde900116f6ac79f78fabdc
+  metadata.gz: 6db227dd5245c47c243c9cd74dd7b11420b090c04ae179ba7d13fa6e474037b0
+  data.tar.gz: 308cf6cfb738e651a13762cdadb4f5e61c28b91b721034fcd106f4c28ade020d
 SHA512:
-  metadata.gz: 86d7db185d6028ef1874310f0e4a7f575afcbf463870e77ab044a8b8bddea61d6a58410f24705a78ae3a7d252120c7c33739418ca62c9eb40b1d543e4616a740
-  data.tar.gz: 9d7fc586d9f5af93bca7e994005fcedc56d6f0942296d4aad9e6d8ae1c0da4d013392ff4c7cc1eb2b09bdc4fe466d9bc888e573300de0c520d27da8a20e7e0a1
+  metadata.gz: fd1e439b56351b61149392971a79563b004a4d445b918a609ac1d023e42bfb6cadb0ed4536dee8fb60d95df2720cd845e0e1ffe27bb35c3ad9c8f8c4eac6190e
+  data.tar.gz: b7b19675211636fac49f372cd7314f3de7fd070f7a9be5a15b1344c0920223f42ace44bec514fd32f46e628d87797a791970797755e7f335f79f5773bf65f36b

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    gitea-client (1.4.0)
+    gitea-client (1.5.7)
       rest-client (~> 2.1.0)
 
 GEM
@@ -48,6 +48,7 @@ GEM
 
 PLATFORMS
   -darwin-21
+  arm64-darwin-21
   x86_64-darwin-20
 
 DEPENDENCIES

data/README.md

@@ -17,6 +17,7 @@ And then execute:
 Or install it yourself as:
 
     $ gem install gitea-client
+    
 
 ## Usage Example
 

data/lib/gitea/api/hat/admin.rb

@@ -0,0 +1,13 @@
+module Gitea
+  module Api
+    module Hat
+      module Admin
+
+        def patch_admin_users_by_username(username, opt = {})
+          @http.patch("/admin/users/#{username}", opt)
+        end
+
+      end # Admin
+    end # Hat 
+  end # Api
+end # Gitea

data/lib/gitea/api/hat/client.rb

@@ -0,0 +1,48 @@
+module Gitea
+  module Api
+    module Hat 
+      class Client 
+
+        # 构造Api client，用于操作Api数据
+        # @param opts [Hash] 构造client时的参数选项
+        # @option opts [string] domain [必填] gitea服务地址
+        # @option opts [string] hat_base_url [必填] api相对路径
+        # @option opts [string] admin_username [必填] 管理员账号
+        # @option opts [string] admin_password [必填] 管理员密码
+        # @option opts [string] username [选填] 用户账号
+        # @option opts [string] password [选填] 用户密码
+        # @option opts [string] gitea_token [选填] 用户token
+        def initialize(opts)
+          @config = Config.new(opts)
+          Gitea::Common::Logging.set_log_file(@config.log_filepath)
+          @http = Http.new(@config)
+        end
+  
+        def config 
+          @config
+        end
+  
+        def config=(config)
+          unless config.is_a?(Gitea::Api::Hat::Config)
+            fail Exception, "load config failure!"
+          end
+          @config = config
+          @http = Http.new(config)
+        end
+  
+        def token 
+          @config.token 
+        end
+  
+        def token=(token)
+          @config.token = token 
+        end
+  
+        include Gitea::Api::Hat::Repository
+        include Gitea::Api::Hat::Users
+        include Gitea::Api::Hat::Organization
+        include Gitea::Api::Hat::Admin
+      end
+    end # Hat 
+  end # Api
+end # Gitea

data/lib/gitea/api/hat/config.rb

@@ -0,0 +1,36 @@
+module Gitea 
+  module Api
+
+    module Hat 
+      class Config < Common::Struct::Base
+        attrs :domain, :hat_base_url, :username, :password, :token, :open_timeout, :read_timeout, :log_filepath
+  
+        def initialize(opts = {})
+          super(opts)
+  
+          valid!
+          normalize_domain
+        end
+  
+        private 
+        def valid!
+          if @domain.nil? || @hat_base_url.nil?
+            fail Exception, "@domain, @hat_base_url not permit blank."
+          end
+        end
+  
+        def normalize_domain
+          uri = URI.parse(domain)
+          uri = URI.parse(domain)
+          uri = URI.parse("http://#{domain}") unless uri.scheme
+  
+          if uri.scheme != 'http' and uri.scheme != 'https'
+            fail ClientError, "Only HTTP and HTTPS domain are accepted."
+          end
+  
+          @domain = uri
+        end
+      end
+    end # Hat
+  end # Api
+end # Gitea

data/lib/gitea/api/hat/http.rb

@@ -0,0 +1,132 @@
+require 'base64'
+require 'json'
+
+module Gitea
+  module Api
+    module Hat 
+      class Http 
+        DEFAULT_CONTENT_TYPE = 'application/json'
+        TOKEN_HEADER = 'Authorization'
+        OPEN_TIMEOUT = 10
+        READ_TIMEOUT = 120
+  
+  
+        def initialize(config)
+          @config = config 
+        end
+
+        include Gitea::Common::Logging
+  
+        def get_request_url(api_url)
+          url = @config.domain.dup
+          url.query = nil
+          url.fragment = nil 
+          [url.to_s, @config.hat_base_url, api_url].join('')
+        end
+  
+        def get(api_url = '', http_options = {}, &block)
+          do_request('GET', api_url, http_options, &block)
+        end
+  
+        def put(api_url = '', http_options = {}, &block)
+          do_request('PUT', api_url, http_options, &block)
+        end
+  
+        def patch(api_url = '', http_options = {}, &block)
+          do_request('PATCH', api_url, http_options, &block)
+        end
+  
+        def post(api_url = '', http_options = {}, &block)
+          do_request('POST', api_url, http_options, &block)
+        end
+  
+        def delete(api_url = '', http_options = {}, &block)
+          do_request('DELETE', api_url, http_options, &block)
+        end
+  
+        def head(api_url = '', http_options = {}, &block)
+          do_request('HEAD', api_url, http_options, &block)
+        end
+  
+        def options(api_url = '', http_options = {}, &block)
+          do_request('OPTIONS', api_url, http_options, &block)
+        end
+  
+        private 
+        # Do Http request 
+        def do_request(verb, api_url, http_options = {}, &block)
+  
+          headers = http_options[:headers] || {}
+          headers['user-agent'] = get_user_agent
+          headers['date'] = Time.now.httpdate
+          headers['content-type'] ||= DEFAULT_CONTENT_TYPE
+  
+          if @config.username and @config.password
+            headers[TOKEN_HEADER] = 'Basic ' + Base64::encode64(@config.username + ":" + @config.password)
+          end
+  
+          headers[:params] = http_options[:query] || {}
+          headers[:params].merge!({access_token: @config.token}) if @config.token
+          logger.info("Gitea Hat Client Begin a Request!...")
+          logger.info("Send HTTP request, verb: #{verb}, http_options: #{http_options}")
+          logger.info("Relative Url: #{api_url}")
+          logger.info("Headers: #{headers}")
+          request = RestClient::Request.new(
+            :method => verb,
+            :url => get_request_url(api_url),
+            :headers => headers, 
+            :payload => http_options[:body],
+            :open_timeout => @config.open_timeout || OPEN_TIMEOUT,
+            :read_timeout => @config.read_timeout || READ_TIMEOUT
+          )
+  
+  
+          response = request.execute do |resp, &blk|
+            if resp.code >= 300 
+              e = Gitea::Api::ServerError.new(resp)
+              logger.error(e.to_s)
+              raise e 
+            else 
+              resp.return!(&blk)
+            end
+          end
+  
+          # If streaming read_body is used, we need to create the
+          # RestClient::Response ourselves
+          unless response.is_a?(RestClient::Response)
+            if response.code.to_i >= 300
+              body = response.body
+              if RestClient::version < '2.1.0'
+                body = RestClient::Request.decode(response['content-encoding'], response.body)
+              end
+              response = RestClient::Response.create(body, response, request)
+              e = Gitea::Api::ServerError.new(response)
+              logger.error(e.to_s)
+              raise e
+            end
+            response = RestClient::Response.create(nil, response, request)
+            response.return!
+          end 
+          
+          begin
+            if response.headers.has_key?(:x_total) || response.headers.has_key?(:x_total_count)
+              return {data: JSON.parse(response), total_data: response.headers[:x_total_count]}
+            else 
+              return JSON.parse(response) 
+            end 
+          rescue => e
+            logger.error(e.to_s)
+            return {}
+          end
+
+          logger.info("Gitea Hat Client Success End a Request!...")
+        end
+  
+        def get_user_agent
+          "gitea-client/#{VERSION}"
+        end
+  
+      end 
+    end # Hat 
+  end # Common 
+end # Gitea

data/lib/gitea/api/hat/organization.rb

@@ -0,0 +1,25 @@
+module Gitea 
+  module Api 
+    module Hat 
+      module Organization 
+        
+        def patch_orgs_by_org(org, opt = {})
+          @http.patch("/orgs/#{org}", opt)
+        end
+
+        def post_orgs(opt = {})
+          @http.post("/orgs", opt)
+        end
+
+        def put_teams_repos_by_id_org(id, org, opt = {})
+          @http.put("/teams/#{id}/repos/#{org}", opt)
+        end
+
+        def delete_teams_repos_by_id_org(id, org, opt = {})
+          @http.delete("/teams/#{id}/repos/#{org}", opt)
+        end
+
+      end # Organization 
+    end # Hat 
+  end # Api 
+end # Gitea

data/lib/gitea/api/hat/repository.rb

@@ -0,0 +1,193 @@
+module Gitea
+  module Api
+    module Hat
+      module Repository
+
+        def get_repos_actions_by_owner_repo(owner, repo, opt = {})
+          @http.get("/repos/#{owner}/#{repo}/actions", opt)
+        end
+
+        def post_repos_actions_runs_jobs_by_owner_repo_run_job(owner, repo, run, job, opt = {})
+          @http.post("/repos/#{owner}/#{repo}/actions/runs/#{run}/jobs/#{job}", opt)
+        end
+
+        def post_repos_actions_runs_rerun_by_owner_repo_run(owner, repo, run, opt = {})
+          @http.post("/repos/#{owner}/#{repo}/actions/runs/#{run}/rerun", opt)
+        end
+
+        def post_repos_actions_runs_jobs_rerun_by_owner_repo_run_job(owner, repo, run, job, opt = {})
+          @http.post("/repos/#{owner}/#{repo}/actions/runs/#{run}/jobs/#{job}/rerun", opt)
+        end
+
+        def get_repos_actions_runs_jobs_logs_by_owner_repo_run_job(owner, repo, run, job, opt = {})
+          @http.get("/repos/#{owner}/#{repo}/actions/runs/#{run}/jobs/#{job}/logs")
+        end
+
+        def post_repos_actions_disable(owner, repo, opt= {})
+          @http.post("/repos/#{owner}/#{repo}/actions/disable", opt)
+        end
+
+        def post_repos_actions_enable(owner, repo, opt= {})
+          @http.post("/repos/#{owner}/#{repo}/actions/enable", opt)
+        end
+
+        def get_repos_contents_by_owner_repo(owner, repo, opt = {})
+          @http.get("/repos/#{owner}/#{repo}/contents", opt)
+        end
+
+        def get_repos_contents_by_owner_repo_filepath(owner, repo, filepath, opt = {})
+          @http.get("/repos/#{owner}/#{repo}/contents/#{filepath}", opt)
+        end
+
+        def get_repos_find_by_owner_repo(owner, repo, opt = {})
+          @http.get("/repos/#{owner}/#{repo}/find", opt)
+        end
+
+        def get_repos_git_commits_by_owner_repo_sha(owner, repo, sha, opt = {})
+          @http.get("/repos/#{owner}/#{repo}/git/commits/#{sha}", opt)
+        end 
+
+        def get_repos_commits_diff_by_owner_repo_sha(owner, repo, sha, opt = {})
+          @http.get("/repos/#{owner}/#{repo}/commits/#{sha}/diff", opt)
+        end
+
+        def post_repos_hooks_by_owner_repo(owner, repo, opt = {}) 
+          @http.post("/repos/#{owner}/#{repo}/hooks", opt)
+        end 
+
+        def patch_repos_hooks_by_owner_repo_id(owner, repo, id, opt = {})
+          @http.patch("/repos/#{owner}/#{repo}/hooks/#{id}", opt)
+        end
+
+        def get_repos_hooks_hooktasks_by_owner_repo_id(owner, repo, id, opt = {})
+          @http.get("/repos/#{owner}/#{repo}/hooks/#{id}/hooktasks", opt)
+        end
+
+        def get_repos_releases_latest_by_owner_repo(owner, repo, opt = {})
+          @http.get("/repos/#{owner}/#{repo}/releases/latest", opt)
+        end
+
+        def get_repos_releases_by_owner_repo(owner, repo, opt = {})
+          @http.get("/repos/#{owner}/#{repo}/releases", opt)
+        end
+
+        def get_repos_releases_by_owner_repo_id(owner, repo, opt = {})
+          @http.get("/repos/#{owner}/#{repo}/releases/#{id}", opt)
+        end
+
+        def post_repos_releases_by_owner_repo(owner, repo, opt = {})
+          @http.post("/repos/#{owner}/#{repo}/releases", opt)
+        end
+
+        def patch_repos_releases_by_owner_repo_id(owner, repo, id, opt = {})
+          @http.patch("/repos/#{owner}/#{repo}/releases/#{id}", opt)
+        end
+
+        def get_repos_branch_name_set_by_owner_repo(owner, repo, opt = {})
+          @http.get("/repos/#{owner}/#{repo}/branch_name_set", opt)
+        end
+
+        def get_repos_branches_by_owner_repo(owner, repo, opt={})
+          @http.get("/repos/#{owner}/#{repo}/branches", opt)
+        end
+
+        def get_repos_branches_branches_slice_by_owner_repo(owner, repo, opt = {})
+          @http.get("/repos/#{owner}/#{repo}/branches/branches_slice", opt)
+        end
+
+        def post_repos_branches_restore_by_owner_repo(owner, repo, opt = {})
+          @http.post("/repos/#{owner}/#{repo}/branches/restore", opt)
+        end
+
+        def get_repos_tag_name_set_by_owner_repo(owner, repo, opt = {})
+          @http.get("/repos/#{owner}/#{repo}/tag_name_set", opt)
+        end
+
+        def get_repos_tags_by_owner_repo(owner, repo, opt = {})
+          @http.get("/repos/#{owner}/#{repo}/tags", opt)
+        end
+
+        def get_repos_tags_by_owner_repo_tag(owner, repo, tag, opt = {})
+          @http.get("/repos/#{owner}/#{repo}/tags/#{tag}", opt)
+        end
+
+        def get_repos_branch_tag_count_by_owner_repo(owner, repo, opt = {})
+          @http.get("/repos/#{owner}/#{repo}/branch_tag_count", opt)
+        end
+
+        def get_repos_readme_by_owner_repo(owner, repo, opt = {})
+          @http.get("/repos/#{owner}/#{repo}/readme", opt)
+        end
+
+        def get_repos_readme_by_owner_repo_filepath(owner, repo, filepath, opt = {})
+          @http.get("/repos/#{owner}/#{repo}/readme/#{filepath}", opt)
+        end
+
+        def get_repos_commits_slice_by_owner_repo(owner, repo, opt = {})
+          @http.get("/repos/#{owner}/#{repo}/commits_slice", opt)
+        end
+
+        def get_repos_recent_commits_by_owner_repo(owner, repo, opt = {})
+          @http.get("/repos/#{owner}/#{repo}/recent_commits", opt)
+        end
+
+        def get_repos_contributors_by_owner_repo(owner, repo, opt = {})
+          @http.get("/repos/#{owner}/#{repo}/contributors", opt)
+        end
+
+        def get_repos_contributors_stat_by_owner_repo(owner, repo, opt = {})
+          @http.get("/repos/#{owner}/#{repo}/contributors/stat", opt)
+        end
+
+        def get_repos_code_stats_by_owner_repo(owner, repo, opt = {})
+          @http.get("/repos/#{owner}/#{repo}/code_stats", opt)
+        end
+
+        def get_repos_count_by_owner_repo(owner, repo, opt = {})
+          @http.get("/repos/#{owner}/#{repo}/count", opt)
+        end
+
+        def get_repos_file_commits_by_owner_repo_filepath(owner, repo, filepath, opt = {})
+          @http.get("/repos/#{owner}/#{repo}/file_commits/#{filepath}", opt)
+        end
+
+        def get_repos_blame_by_owner_repo(owner, repo, opt = {})
+          @http.get("/repos/#{owner}/#{repo}/blame", opt)
+        end
+
+        def get_repos_compare_by_owner_repo_baseref_headref(owner, repo, baseRef, headRef, opt = {})
+          @http.get("/repos/#{owner}/#{repo}/compare/#{baseRef}...#{headRef}", opt)
+        end
+
+        def post_repos_transfer_by_owner_repo(owner, repo, opt = {})
+          @http.post("/repos/#{owner}/#{repo}/transfer", opt)
+        end
+
+        def get_repos_pulls_by_owner_repo_index(owner, repo, index, opt = {})
+          @http.get("/repos/#{owner}/#{repo}/pulls/#{index}", opt)
+        end
+
+        def get_repos_pulls_commits_by_owner_repo_index(owner, repo, index, opt = {})
+          @http.get("/repos/#{owner}/#{repo}/pulls/#{index}/commits", opt)
+        end
+
+        def get_repos_pulls_files_by_owner_repo_index(owner, repo, index, opt = {})
+          @http.get("/repos/#{owner}/#{repo}/pulls/#{index}/files", opt)
+        end
+
+        def post_repos_contents_batch_by_owner_repo(owner, repo, opt = {})
+          @http.post("/repos/#{owner}/#{repo}/contents/batch", opt)
+        end
+
+        def get_repos_pulls_versions_by_owner_repo_index(owner, repo, index, opt = {})
+          @http.get("/repos/#{owner}/#{repo}/pulls/#{index}/versions", opt)
+        end
+
+        def get_repos_pulls_versions_diff_by_owner_repo_index_id(owner, repo, index, versionID, opt = {})
+          @http.get("/repos/#{owner}/#{repo}/pulls/#{index}/versions/#{versionID}/diff", opt)
+        end
+
+      end # Repository 
+    end # Hat 
+  end # Api 
+end # Gitea

data/lib/gitea/api/hat/users.rb

@@ -0,0 +1,13 @@
+module Gitea 
+  module Api 
+    module Hat 
+      module Users
+
+        def get_users_heatmap_by_username(username, opt = {})
+          @http.get("/users/#{username}/heatmap", opt)
+        end
+        
+      end # Users 
+    end # Hat
+  end # Api
+end # Gitea

data/lib/gitea/api.rb

@@ -11,3 +11,10 @@ require_relative 'api/client'
 require_relative 'api/config'
 require_relative 'api/exception'
 require_relative 'api/http'
+require_relative 'api/hat/repository'
+require_relative 'api/hat/organization'
+require_relative 'api/hat/users'
+require_relative 'api/hat/admin'
+require_relative 'api/hat/client'
+require_relative 'api/hat/config'
+require_relative 'api/hat/http'

data/lib/gitea/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Gitea
-  VERSION = "1.5.0"
+  VERSION = "1.5.7"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: gitea-client
 version: !ruby/object:Gem::Version
-  version: 1.5.0
+  version: 1.5.7
 platform: ruby
 authors:
 - viletyy
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-04-26 00:00:00.000000000 Z
+date: 2024-05-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rest-client
@@ -49,6 +49,13 @@ files:
 - lib/gitea/api/client.rb
 - lib/gitea/api/config.rb
 - lib/gitea/api/exception.rb
+- lib/gitea/api/hat/admin.rb
+- lib/gitea/api/hat/client.rb
+- lib/gitea/api/hat/config.rb
+- lib/gitea/api/hat/http.rb
+- lib/gitea/api/hat/organization.rb
+- lib/gitea/api/hat/repository.rb
+- lib/gitea/api/hat/users.rb
 - lib/gitea/api/http.rb
 - lib/gitea/api/issue.rb
 - lib/gitea/api/miscellaneous.rb