gitea-client 1.1.0 → 1.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 517dff3ae1c4e8c77314d382aef806d76eb38d66c02ad0afd09d4053052d0a60
-  data.tar.gz: 214cc5d7e29be3cd61eff0dc0e893d8ca6872de37c032eba68fbc04920d27fe2
+  metadata.gz: 7221d24fa5a724c415fc2490ca1a1567ac907c98e96d45042561b78eda3a9110
+  data.tar.gz: 3340b98ed8fc5b5910f647154c983bc04b2220beccbc4cd22e7b38c8643fd3f6
 SHA512:
-  metadata.gz: 603b3fcef6610caca3db0229f290283c451e8666244b8b5c8562bbf93ea22a0f1167be3b9341f50e0acf976810a8eeb76bbc413e62a3c6237924fbfa99701dbc
-  data.tar.gz: 8d877055b99f63d9b1540a8aaa58a39aec04de84d2128ab4372224e4d4ee1c1e63329384ea339b284b2e2af8221a315fd68b87d599224f06279ce39225b34921
+  metadata.gz: 391c01bcea34e8fa6903684ed02bf5dd462dd3f79dfe8501db6c2d2df519016d0a9dc7d06acb1a4526f60c15c94b965093eb60de1c29160910f5b2fd069295b6
+  data.tar.gz: 8048f7a3cea833fb27c351b7db8c8ef518f5c4f61bdeb449cb8e27bbf59ef345641b97fe266d985e15df50aa346166a8735cda654705b5cf4a2565ea75f574ec

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    gitea-client (0.10.0)
+    gitea-client (1.1.0)
       rest-client (~> 2.1.0)
 
 GEM

data/lib/gitea/api/client.rb

@@ -13,6 +13,7 @@ module Gitea
       # @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
 

data/lib/gitea/api/config.rb

@@ -2,7 +2,7 @@ module Gitea
   module Api
 
     class Config < Common::Struct::Base
-      attrs :domain, :base_url, :username, :password, :token, :open_timeout, :read_timeout
+      attrs :domain, :base_url, :username, :password, :token, :open_timeout, :read_timeout, :log_filepath
 
       def initialize(opts = {})
         super(opts)

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,156 @@
+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_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/http.rb

@@ -65,7 +65,10 @@ module Gitea
 
         headers[:params] = http_options[:query] || {}
         headers[:params].merge!({access_token: @config.token}) if @config.token
-        logger.debug("Send HTTP request, verb: #{verb}, http_options: #{http_options}")
+        logger.info("Gitea 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,
@@ -102,13 +105,21 @@ module Gitea
           end
           response = RestClient::Response.create(nil, response, request)
           response.return!
-        end        
+        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!...")
 
-        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 {}
       end
 
       def get_user_agent

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.1.0"
+  VERSION = "1.2.1"
 end

metadata

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