增加高压空闲调节
This commit is contained in:
@@ -0,0 +1,184 @@
|
||||
|
||||
"""
|
||||
The MIT License (MIT)
|
||||
Copyright © 2019 Jean-Christophe Bos & HC² (www.hc2.fr)
|
||||
"""
|
||||
|
||||
import re
|
||||
|
||||
# ============================================================================
|
||||
# ===( @WebRoute decorator )==================================================
|
||||
# ============================================================================
|
||||
|
||||
def WebRoute(method=None, routePath=None, name=None) :
|
||||
|
||||
if type(method) is type(lambda x:x) and not routePath :
|
||||
raise ValueError('[@WebRoute] arguments are required for this decorator.')
|
||||
|
||||
def decorated(handler) :
|
||||
RegisterRoute(handler, method, routePath, name)
|
||||
s = (' (%s)' % name) if name else ''
|
||||
print(' + [@WebRoute] %s %s' % (method, routePath) + s)
|
||||
return handler
|
||||
|
||||
return decorated
|
||||
|
||||
# ============================================================================
|
||||
# ===( RegisterResult )=======================================================
|
||||
# ============================================================================
|
||||
|
||||
def RegisterRoute(handler, method, routePath, name=None) :
|
||||
if type(handler) is not type(lambda x:x) :
|
||||
raise ValueError('"handler" must be a function.')
|
||||
if not isinstance(method, str) or len(method) == 0 :
|
||||
raise ValueError('"method" requires a not empty string.')
|
||||
if not isinstance(routePath, str) or len(routePath) == 0 :
|
||||
raise ValueError('"routePath" requires a not empty string.')
|
||||
if routePath[0] != '/' :
|
||||
raise ValueError('"routePath" must start with a "/".')
|
||||
if name is not None and not isinstance(name, str) :
|
||||
raise ValueError('"name" must be a string or None.')
|
||||
method = method.upper()
|
||||
if len(routePath) > 1 and routePath.endswith('/') :
|
||||
routePath = routePath[:-1]
|
||||
# Route -> '/users/<uID>/addresses/<addrID>/test/<anotherID>'
|
||||
# Regex -> '/users/(\w*)/addresses/(\w*)/test/(\w*)$'
|
||||
# Args -> ['uID', 'addrID', 'anotherID']
|
||||
argNames = [ ]
|
||||
regex = ''
|
||||
try :
|
||||
for i, part in enumerate(routePath.lower().split('/')) :
|
||||
if i > 0 :
|
||||
if part.startswith('<') and part.endswith('>') :
|
||||
argName = part[1:-1]
|
||||
if not argName :
|
||||
raise Exception
|
||||
argNames.append(argName)
|
||||
regex += '/([\\w.]*)'
|
||||
else :
|
||||
regex += '/' + part
|
||||
regex = re.compile(regex + '$')
|
||||
except :
|
||||
raise ValueError('Bad route path: "%s".' % routePath)
|
||||
for regRoute in _registeredRoutes :
|
||||
if regRoute.Method == method and regRoute.Regex == regex :
|
||||
raise ValueError('Duplicated route: "%s".' % routePath)
|
||||
regRoute = _registeredRoute(handler, method, routePath, name, regex, argNames)
|
||||
_registeredRoutes.append(regRoute)
|
||||
|
||||
# ============================================================================
|
||||
# ===( ResolveRoute )=========================================================
|
||||
# ============================================================================
|
||||
|
||||
def ResolveRoute(method, path) :
|
||||
try :
|
||||
path = path.lower()
|
||||
if len(path) > 1 and path.endswith('/') :
|
||||
path = path[:-1]
|
||||
for regRoute in _registeredRoutes :
|
||||
if regRoute.Method == method :
|
||||
reMatch = regRoute.Regex.match(path)
|
||||
if reMatch :
|
||||
if not regRoute.ArgNames :
|
||||
return RouteResult(regRoute)
|
||||
args = { }
|
||||
for i, argName in enumerate(regRoute.ArgNames) :
|
||||
argValue = reMatch.group(i+1)
|
||||
try :
|
||||
argValue = int(argValue)
|
||||
except :
|
||||
pass
|
||||
args[argName] = argValue
|
||||
return RouteResult(regRoute, args)
|
||||
except :
|
||||
pass
|
||||
return None
|
||||
|
||||
# ============================================================================
|
||||
# ===( PathFromRoute )========================================================
|
||||
# ============================================================================
|
||||
|
||||
def PathFromRoute(routeName, routeArgs={ }) :
|
||||
if not isinstance(routeName, str) or len(routeName) == 0 :
|
||||
raise ValueError('"routeName" requires a not empty string.')
|
||||
if not isinstance(routeArgs, dict) :
|
||||
raise ValueError('"routeArgs" must be a dict.')
|
||||
for regRoute in _registeredRoutes :
|
||||
if regRoute.Name == routeName :
|
||||
path = regRoute.RoutePath
|
||||
for argName in regRoute.ArgNames :
|
||||
arg = routeArgs.get(argName, None)
|
||||
if arg is None :
|
||||
raise ValueError('"routeArgs" does not contains "%s" for route %s.' % (argName, routeName))
|
||||
path = path.replace('<%s>' % argName, str(arg))
|
||||
return path
|
||||
raise ValueError('"routeName" is not a registered route (%s).' % routeName)
|
||||
|
||||
# ============================================================================
|
||||
# ===( RouteResult )==========================================================
|
||||
# ============================================================================
|
||||
|
||||
class RouteResult :
|
||||
|
||||
def __init__(self, regRoute, args=None) :
|
||||
self._regRoute = regRoute
|
||||
self._args = args
|
||||
|
||||
def __repr__(self) :
|
||||
if self._regRoute.Name :
|
||||
return self._regRoute.Name
|
||||
return '%s %s' % (self._regRoute.Method, self._regRoute.RoutePath)
|
||||
|
||||
@property
|
||||
def Handler(self) :
|
||||
return self._regRoute.Handler
|
||||
|
||||
@property
|
||||
def Method(self) :
|
||||
return self._regRoute.Method
|
||||
|
||||
@property
|
||||
def RoutePath(self) :
|
||||
return self._regRoute.RoutePath
|
||||
|
||||
@property
|
||||
def Name(self) :
|
||||
return self._regRoute.Name
|
||||
|
||||
@property
|
||||
def Args(self) :
|
||||
return self._args
|
||||
|
||||
# ============================================================================
|
||||
# ===( Methods )==============================================================
|
||||
# ============================================================================
|
||||
|
||||
GET = 'GET'
|
||||
HEAD = 'HEAD'
|
||||
POST = 'POST'
|
||||
PUT = 'PUT'
|
||||
DELETE = 'DELETE'
|
||||
OPTIONS = 'OPTIONS'
|
||||
PATCH = 'PATCH'
|
||||
|
||||
# ============================================================================
|
||||
# ===( Private registered routes )===========================================
|
||||
# ============================================================================
|
||||
|
||||
_registeredRoutes = [ ]
|
||||
|
||||
# ------------------------------------------------------------------------
|
||||
|
||||
class _registeredRoute :
|
||||
|
||||
def __init__(self, handler, method, routePath, name, regex, argNames) :
|
||||
self.Handler = handler
|
||||
self.Method = method
|
||||
self.RoutePath = routePath
|
||||
self.Name = name
|
||||
self.Regex = regex
|
||||
self.ArgNames = argNames
|
||||
|
||||
# ============================================================================
|
||||
# ============================================================================
|
||||
# ============================================================================
|
||||
Reference in New Issue
Block a user