gitea-client 1.2.0 → 1.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5e03268e71d8f489029b7581e2d8027acf0ba861dd46c5303963391bcc7dfa3b
-  data.tar.gz: 0e4ad31b6bec7d2e0f2eb47813ac78715a47edc5ba721bcf53dcf901cfc4f612
+  metadata.gz: 2b75477f05c754a32a9fc8e41b1a31930f47d801b1ddda915bc743adf6c11440
+  data.tar.gz: d3bc6a211bd17fbd06f8fde913d6b2bcc8cd8cd1ce21b102da93f29dda25a7bc
 SHA512:
-  metadata.gz: 7875a1285c452b7c64111befc0ee6bd0522606485f78af1f20dc1b0e211a573eed40a9c52cd2f842282db453a166ff0faacb228aee8ee76cd21de248496573e5
-  data.tar.gz: 92763d71fb9dc0f55987756c3c604f0121e0fb201d2cd821ee9858a3e7d3d7b4fd13f1603588be7c5934cd6c79d018aa0cba0e61c6a6605fd2860fa9404cd766
+  metadata.gz: 25f5237e147d81e0d83c316028b61425ad4ce85b2a3ec397ca37ae33a776aa7f867f9be75388e0916cbfcf2e7a007a8263916e437544252e33dbc33a159b7cd7
+  data.tar.gz: 6924cf7e55139ac00733bede4f9160dc50998583634d0e1d6dd3a08c45b23d67565c7851061cbd11f790972534697644a43f2281bc2084b78c2a1ecfac68aee3

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)
+              return {data: JSON.parse(response), total_data: response.headers[:x_total]}
+            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,160 @@
+module Gitea
+  module Api
+    module Hat
+      module Repository
+        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 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_branches_slice_by_owner_repo(owner, repo, opt = {})
+          @http.get("/repos/#{owner}/#{repo}/branches/branches_slice", 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_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, filepath, opt = {})
+          @http.get("/repos/#{owner}/#{repo}/commits_slice", opt)
+        end
+
+        def get_repos_contributors_by_owner_repo(owner, repo, opt = {})
+          @http.get("/repos/#{owner}/#{repo}/contributors", 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 get_repos_wikies_by_owner_repo(owner, repo, opt = {})
+          @http.get("/repos/#{owner}/#{repo}/wikies", opt)
+        end
+
+        def post_repos_wikies_by_owner_repo(owner, repo, opt = {})
+          @http.post("/repos/#{owner}/#{repo}/wikies", opt)
+        end
+
+        def patch_repos_wikies_by_owner_repo_pagename(owner, repo, pageName, opt = {})
+          @http.patch("/repos/#{owner}/#{repo}/wikies/#{pageName}", opt)
+        end
+
+        def get_repos_wikies_by_owner_repo_pagename(owner, repo, pageName, opt = {})
+          @http.get("/repos/#{owner}/#{repo}/wikies/#{pageName}", opt)
+        end
+
+        def delete_repos_wikies_by_owner_repo_pagename(owner, repo, pageName, opt = {})
+          @http.delete("/repos/#{owner}/#{repo}/wikies/#{pageName}", 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.2.0"
+  VERSION = "1.2.2"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: gitea-client
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.2.2
 platform: ruby
 authors:
 - viletyy
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-01-31 00:00:00.000000000 Z
+date: 2023-02-03 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