iframe-proxy | Sunbelt Computer Software

History

225 lines (188 loc) · 8.14 KB

Raw

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

143

144

145

146

147

148

149

150

151

152

153

154

155

156

157

158

159

160

161

162

163

164

165

166

167

168

169

170

171

172

173

174

175

176

177

178

179

180

181

182

183

184

185

186

187

188

189

190

191

192

193

194

195

196

197

198

199

200

201

202

203

204

205

206

207

208

209

210

211

212

213

214

215

216

217

218

219

220

221

222

223

224

225

############################ Copyrights and license ############################

# #

# This file is part of PyGithub. #

# http://pygithub.readthedocs.io/ #

# #

# PyGithub is free software: you can redistribute it and/or modify it under #

# the terms of the GNU Lesser General Public License as published by the Free #

# Software Foundation, either version 3 of the License, or (at your option) #

# any later version. #

# #

# PyGithub is distributed in the hope that it will be useful, but WITHOUT ANY #

# WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS #

# FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more #

# details. #

# #

# You should have received a copy of the GNU Lesser General Public License #

# along with PyGithub. If not, see <http://www.gnu.org/licenses/>. #

# #

################################################################################

from __future__ import annotations

import json

from typing import Any

class GithubException(Exception):

"""

Error handling in PyGithub is done with exceptions. This class is the base of all exceptions raised by PyGithub

(but :class:`github.GithubException.BadAttributeException`).

Some other types of exceptions might be raised by underlying libraries, for example for network-related issues.

"""

def __init__(

self,

status: int,

data: Any = None,

headers: dict[str, str] | None = None,

message: str | None = None,

super().__init__()

self.__status = status

self.__data = data

self.__headers = headers

self.__message = message

self.args = (status, data, headers, message)

@property

def message(self) -> str | None:

return self.__message

@property

def status(self) -> int:

"""

The status returned by the Github API.

"""

return self.__status

@property

def data(self) -> Any:

"""

The (decoded) data returned by the Github API.

"""

return self.__data

@property

def headers(self) -> dict[str, str] | None:

"""

The headers returned by the Github API.

"""

return self.__headers

def __repr__(self) -> str:

return f"{self.__class__.__name__}({self.__str__()})"

def __str__(self) -> str:

if self.__message:

msg = f"{self.__message}: {self.status}"

else:

msg = f"{self.status}"

if self.data is not None:

data = self.data

if isinstance(data, bytes):

data = data.decode("utf-8", errors="replace")

msg += " " + json.dumps(data)

return msg

class BadCredentialsException(GithubException):

"""

Exception raised in case of bad credentials (when Github API replies with a 401 or 403 HTML status)

"""

class UnknownObjectException(GithubException):

"""

Exception raised when a non-existing object is requested (when Github API replies with a 404 HTML status)

"""

class BadUserAgentException(GithubException):

"""

Exception raised when request is sent with a bad user agent header (when Github API replies with a 403 bad user

agent HTML status)

"""

class RateLimitExceededException(GithubException):

"""

Exception raised when the rate limit is exceeded (when Github API replies with a 403 rate limit exceeded HTML

status)

"""

class RateLimitExceededExceedsMaxWait(RateLimitExceededException):

"""

Exception raised when the wait required to respect a rate limit reset exceeds the configured

``max_rate_limit_wait`` on ``GithubRetry``, instead of blocking until the rate limit resets.

"""

def __init__(

self,

status: int,

data: Any = None,

headers: dict[str, str] | None = None,

message: str | None = None,

wait: float | None = None,

super().__init__(status, data, headers, message)

self.__wait = wait

@property

def wait(self) -> float | None:

"""

The backoff in seconds that would have been required to respect the rate limit reset, before it was capped by

``max_rate_limit_wait``.

"""

return self.__wait

class BadAttributeException(Exception):

"""

Exception raised when Github returns an attribute with the wrong type.

"""

def __init__(

self,

actualValue: Any,

expectedType: (

dict[tuple[type[str], type[str]], type[dict]]

| tuple[type[str], type[str]]

| list[type[dict]]

| list[tuple[type[str], type[str]]]

transformationException: Exception | None,

self.__actualValue = actualValue

self.__expectedType = expectedType

self.__transformationException = transformationException

@property

def actual_value(self) -> Any:

"""

The value returned by Github.

"""

return self.__actualValue

@property

def expected_type(

self,

) -> (

list[type[dict]]

| tuple[type[str], type[str]]

| dict[tuple[type[str], type[str]], type[dict]]

| list[tuple[type[str], type[str]]]

"""

The type PyGithub expected.

"""

return self.__expectedType

@property

def transformation_exception(self) -> Exception | None:

"""

The exception raised when PyGithub tried to parse the value.

"""

return self.__transformationException

class TwoFactorException(GithubException):

"""

Exception raised when Github requires a onetime password for two-factor authentication.

"""

class IncompletableObject(GithubException):

"""

Exception raised when we can not request an object from Github because the data returned did not include a URL.

"""

Sunbelt Computer Software

PL/B Language Development and Support

Navigation Menu

Uh oh!

Uh oh!

Sunbelt Computer Software

PL/B Language Development and Support

Uh oh!

Uh oh!

FilesExpand file tree

GithubException.py

Latest commit

History

GithubException.py

File metadata and controls