gitea-client 1.4.0 → 1.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f693d44ba06b1038fcf43a6b9341f3c7017d5451f699b11bc890a98477df7c80
-  data.tar.gz: bf791479a13f6efbfd2f93a218554d834bec2f8553c1a5d7bd520ca58dcc0ca1
+  metadata.gz: 87ee860a7bcea67ed6b06781b81ae626cac7964ee5985d6090acdc382d03f4fa
+  data.tar.gz: 75beb5a00cbc08c30f3ae6ce0679bb2e6dc8dfa1ef75df2ed2caf05dff8ca17c
 SHA512:
-  metadata.gz: f39ca2ed50976eefc01908b0714d7234af60fa2a985986bfe93f455cd20a1f4bf58ae945658009fd869ac0584cbed121dd7257b992b2f4049b92d02f3ec18b69
-  data.tar.gz: 6dfd8596162d3b11e4b5c3540a805bcc84cbcc0c6e2d4a3e4c7181c15bd86db1843a7efc97fc87abf64f10075bb75bb992235f6923d09e6e375ac61360ac14aa
+  metadata.gz: 9c56c0a6bb6fa9f3fdd445762966ddb58b239c71d1b4a7326e1abb2bcc6cbc47815c5000f535ffdcc03d40ceaee7a8e0395db55b7dd5253ab3ff2a761f388693
+  data.tar.gz: 8d5a1f9e312b3e6357eda0ecb24dbc50cab698e933186038be2247502bc55e177045fc0c761ddd886492a600021b0f0d9b176a4703fbadc43dfefb64f2b83bcd

data/Gemfile.lock

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

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,168 @@
+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 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 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.4.0"
+  VERSION = "1.4.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: gitea-client
 version: !ruby/object:Gem::Version
-  version: 1.4.0
+  version: 1.4.1
 platform: ruby
 authors:
 - viletyy
@@ -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