297 lines
9.4 KiB
Python
297 lines
9.4 KiB
Python
# coding: utf-8
|
|
|
|
"""
|
|
Gitea API.
|
|
|
|
This documentation describes the Gitea API. # noqa: E501
|
|
|
|
OpenAPI spec version: 1.17.0+rc1
|
|
|
|
Generated by: https://github.com/swagger-api/swagger-codegen.git
|
|
"""
|
|
|
|
|
|
from __future__ import absolute_import
|
|
|
|
import copy
|
|
import logging
|
|
import multiprocessing
|
|
import sys
|
|
import urllib3
|
|
|
|
import six
|
|
from six.moves import http_client as httplib
|
|
|
|
|
|
class Configuration(object):
|
|
"""NOTE: This class is auto generated by the swagger code generator program.
|
|
|
|
Ref: https://github.com/swagger-api/swagger-codegen
|
|
Do not edit the class manually.
|
|
"""
|
|
|
|
_default = None
|
|
|
|
def __init__(self):
|
|
"""Constructor"""
|
|
if self._default:
|
|
for key in self._default.__dict__.keys():
|
|
self.__dict__[key] = copy.copy(self._default.__dict__[key])
|
|
return
|
|
|
|
# Default Base url
|
|
self.host = "http://localhost/api/v1"
|
|
# Temp file folder for downloading files
|
|
self.temp_folder_path = None
|
|
|
|
# Authentication Settings
|
|
# dict to store API key(s)
|
|
self.api_key = {}
|
|
# dict to store API prefix (e.g. Bearer)
|
|
self.api_key_prefix = {}
|
|
# function to refresh API key if expired
|
|
self.refresh_api_key_hook = None
|
|
# Username for HTTP basic authentication
|
|
self.username = ""
|
|
# Password for HTTP basic authentication
|
|
self.password = ""
|
|
|
|
# Logging Settings
|
|
self.logger = {}
|
|
self.logger["package_logger"] = logging.getLogger("swagger_client")
|
|
self.logger["urllib3_logger"] = logging.getLogger("urllib3")
|
|
# Log format
|
|
self.logger_format = '%(asctime)s %(levelname)s %(message)s'
|
|
# Log stream handler
|
|
self.logger_stream_handler = None
|
|
# Log file handler
|
|
self.logger_file_handler = None
|
|
# Debug file location
|
|
self.logger_file = None
|
|
# Debug switch
|
|
self.debug = False
|
|
|
|
# SSL/TLS verification
|
|
# Set this to false to skip verifying SSL certificate when calling API
|
|
# from https server.
|
|
self.verify_ssl = True
|
|
# Set this to customize the certificate file to verify the peer.
|
|
self.ssl_ca_cert = None
|
|
# client certificate file
|
|
self.cert_file = None
|
|
# client key file
|
|
self.key_file = None
|
|
# Set this to True/False to enable/disable SSL hostname verification.
|
|
self.assert_hostname = None
|
|
|
|
# urllib3 connection pool's maximum number of connections saved
|
|
# per pool. urllib3 uses 1 connection as default value, but this is
|
|
# not the best value when you are making a lot of possibly parallel
|
|
# requests to the same host, which is often the case here.
|
|
# cpu_count * 5 is used as default value to increase performance.
|
|
self.connection_pool_maxsize = multiprocessing.cpu_count() * 5
|
|
|
|
# Proxy URL
|
|
self.proxy = None
|
|
# Safe chars for path_param
|
|
self.safe_chars_for_path_param = ''
|
|
|
|
# Disable client side validation
|
|
self.client_side_validation = True
|
|
|
|
@classmethod
|
|
def set_default(cls, default):
|
|
cls._default = default
|
|
|
|
@property
|
|
def logger_file(self):
|
|
"""The logger file.
|
|
|
|
If the logger_file is None, then add stream handler and remove file
|
|
handler. Otherwise, add file handler and remove stream handler.
|
|
|
|
:param value: The logger_file path.
|
|
:type: str
|
|
"""
|
|
return self.__logger_file
|
|
|
|
@logger_file.setter
|
|
def logger_file(self, value):
|
|
"""The logger file.
|
|
|
|
If the logger_file is None, then add stream handler and remove file
|
|
handler. Otherwise, add file handler and remove stream handler.
|
|
|
|
:param value: The logger_file path.
|
|
:type: str
|
|
"""
|
|
self.__logger_file = value
|
|
if self.__logger_file:
|
|
# If set logging file,
|
|
# then add file handler and remove stream handler.
|
|
self.logger_file_handler = logging.FileHandler(self.__logger_file)
|
|
self.logger_file_handler.setFormatter(self.logger_formatter)
|
|
for _, logger in six.iteritems(self.logger):
|
|
logger.addHandler(self.logger_file_handler)
|
|
if self.logger_stream_handler:
|
|
logger.removeHandler(self.logger_stream_handler)
|
|
else:
|
|
# If not set logging file,
|
|
# then add stream handler and remove file handler.
|
|
self.logger_stream_handler = logging.StreamHandler()
|
|
self.logger_stream_handler.setFormatter(self.logger_formatter)
|
|
for _, logger in six.iteritems(self.logger):
|
|
logger.addHandler(self.logger_stream_handler)
|
|
if self.logger_file_handler:
|
|
logger.removeHandler(self.logger_file_handler)
|
|
|
|
@property
|
|
def debug(self):
|
|
"""Debug status
|
|
|
|
:param value: The debug status, True or False.
|
|
:type: bool
|
|
"""
|
|
return self.__debug
|
|
|
|
@debug.setter
|
|
def debug(self, value):
|
|
"""Debug status
|
|
|
|
:param value: The debug status, True or False.
|
|
:type: bool
|
|
"""
|
|
self.__debug = value
|
|
if self.__debug:
|
|
# if debug status is True, turn on debug logging
|
|
for _, logger in six.iteritems(self.logger):
|
|
logger.setLevel(logging.DEBUG)
|
|
# turn on httplib debug
|
|
httplib.HTTPConnection.debuglevel = 1
|
|
else:
|
|
# if debug status is False, turn off debug logging,
|
|
# setting log level to default `logging.WARNING`
|
|
for _, logger in six.iteritems(self.logger):
|
|
logger.setLevel(logging.WARNING)
|
|
# turn off httplib debug
|
|
httplib.HTTPConnection.debuglevel = 0
|
|
|
|
@property
|
|
def logger_format(self):
|
|
"""The logger format.
|
|
|
|
The logger_formatter will be updated when sets logger_format.
|
|
|
|
:param value: The format string.
|
|
:type: str
|
|
"""
|
|
return self.__logger_format
|
|
|
|
@logger_format.setter
|
|
def logger_format(self, value):
|
|
"""The logger format.
|
|
|
|
The logger_formatter will be updated when sets logger_format.
|
|
|
|
:param value: The format string.
|
|
:type: str
|
|
"""
|
|
self.__logger_format = value
|
|
self.logger_formatter = logging.Formatter(self.__logger_format)
|
|
|
|
def get_api_key_with_prefix(self, identifier):
|
|
"""Gets API key (with prefix if set).
|
|
|
|
:param identifier: The identifier of apiKey.
|
|
:return: The token for api key authentication.
|
|
"""
|
|
|
|
if self.refresh_api_key_hook:
|
|
self.refresh_api_key_hook(self)
|
|
|
|
key = self.api_key.get(identifier)
|
|
if key:
|
|
prefix = self.api_key_prefix.get(identifier)
|
|
if prefix:
|
|
return "%s %s" % (prefix, key)
|
|
else:
|
|
return key
|
|
|
|
def get_basic_auth_token(self):
|
|
"""Gets HTTP basic authentication header (string).
|
|
|
|
:return: The token for basic HTTP authentication.
|
|
"""
|
|
return urllib3.util.make_headers(
|
|
basic_auth=self.username + ':' + self.password
|
|
).get('authorization')
|
|
|
|
def auth_settings(self):
|
|
"""Gets Auth Settings dict for api client.
|
|
|
|
:return: The Auth Settings information dict.
|
|
"""
|
|
return {
|
|
'AccessToken':
|
|
{
|
|
'type': 'api_key',
|
|
'in': 'query',
|
|
'key': 'access_token',
|
|
'value': self.get_api_key_with_prefix('access_token')
|
|
},
|
|
'AuthorizationHeaderToken':
|
|
{
|
|
'type': 'api_key',
|
|
'in': 'header',
|
|
'key': 'Authorization',
|
|
'value': self.get_api_key_with_prefix('Authorization')
|
|
},
|
|
'BasicAuth':
|
|
{
|
|
'type': 'basic',
|
|
'in': 'header',
|
|
'key': 'Authorization',
|
|
'value': self.get_basic_auth_token()
|
|
},
|
|
'SudoHeader':
|
|
{
|
|
'type': 'api_key',
|
|
'in': 'header',
|
|
'key': 'Sudo',
|
|
'value': self.get_api_key_with_prefix('Sudo')
|
|
},
|
|
'SudoParam':
|
|
{
|
|
'type': 'api_key',
|
|
'in': 'query',
|
|
'key': 'sudo',
|
|
'value': self.get_api_key_with_prefix('sudo')
|
|
},
|
|
'TOTPHeader':
|
|
{
|
|
'type': 'api_key',
|
|
'in': 'header',
|
|
'key': 'X-GITEA-OTP',
|
|
'value': self.get_api_key_with_prefix('X-GITEA-OTP')
|
|
},
|
|
'Token':
|
|
{
|
|
'type': 'api_key',
|
|
'in': 'query',
|
|
'key': 'token',
|
|
'value': self.get_api_key_with_prefix('token')
|
|
},
|
|
|
|
}
|
|
|
|
def to_debug_report(self):
|
|
"""Gets the essential information for debugging.
|
|
|
|
:return: The report for debugging.
|
|
"""
|
|
return "Python SDK Debug Report:\n"\
|
|
"OS: {env}\n"\
|
|
"Python Version: {pyversion}\n"\
|
|
"Version of the API: 1.17.0+rc1\n"\
|
|
"SDK Package Version: 1.0.0".\
|
|
format(env=sys.platform, pyversion=sys.version)
|