ezKit 1.11.14__tar.gz → 1.11.15__tar.gz

{ezkit-1.11.14/ezKit.egg-info → ezkit-1.11.15}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: ezKit
-Version: 1.11.14
+Version: 1.11.15
 Summary: Easy Kit
 Author: septvean
 Author-email: septvean@gmail.com

{ezkit-1.11.14 → ezkit-1.11.15}/ezKit/bottle.py

@@ -14,6 +14,7 @@ License: MIT (see LICENSE for details)
 """
 
 from __future__ import print_function
+
 import sys
 
 __author__ = 'Marcel Hellkamp'
@@ -62,48 +63,66 @@ def _cli_patch(cli_args):  # pragma: no coverage
             eventlet.monkey_patch()
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     _cli_patch(sys.argv)
 
 ###############################################################################
 # Imports and Python 2/3 unification ##########################################
 ###############################################################################
 
-import base64, calendar, email.utils, functools, hmac, itertools,\
-       mimetypes, os, re, tempfile, threading, time, warnings, weakref, hashlib
-
-from types import FunctionType
-from datetime import date as datedate, datetime, timedelta
+import base64
+import calendar
+import email.utils
+import functools
+import hashlib
+import hmac
+import itertools
+import mimetypes
+import os
+import re
+import tempfile
+import threading
+import time
+import warnings
+import weakref
+from datetime import date as datedate
+from datetime import datetime, timedelta
 from tempfile import NamedTemporaryFile
 from traceback import format_exc, print_exc
+from types import FunctionType
 from unicodedata import normalize
 
 try:
-    from ujson import dumps as json_dumps, loads as json_lds
+    from ujson import dumps as json_dumps
+    from ujson import loads as json_lds
 except ImportError:
-    from json import dumps as json_dumps, loads as json_lds
+    from json import dumps as json_dumps
+    from json import loads as json_lds
 
 py = sys.version_info
 py3k = py.major > 2
 
 # Lots of stdlib and builtin differences.
 if py3k:
-    import http.client as httplib
     import _thread as thread
-    from urllib.parse import urljoin, SplitResult as UrlSplitResult
-    from urllib.parse import urlencode, quote as urlquote, unquote as urlunquote
+    import http.client as httplib
+    from urllib.parse import SplitResult as UrlSplitResult
+    from urllib.parse import quote as urlquote
+    from urllib.parse import unquote as urlunquote
+    from urllib.parse import urlencode, urljoin
     urlunquote = functools.partial(urlunquote, encoding='latin1')
-    from http.cookies import SimpleCookie, Morsel, CookieError
-    from collections.abc import MutableMapping as DictMixin
-    from types import ModuleType as new_module
-    import pickle
-    from io import BytesIO
     import configparser
+    import pickle
+    from collections.abc import MutableMapping as DictMixin
     from datetime import timezone
+    from http.cookies import CookieError, Morsel, SimpleCookie
+    from io import BytesIO
+    from types import ModuleType as new_module
     UTC = timezone.utc
     # getfullargspec was deprecated in 3.5 and un-deprecated in 3.6
     # getargspec was deprecated in 3.0 and removed in 3.11
     from inspect import getfullargspec
+
     def getargspec(func):
         spec = getfullargspec(func)
         kwargs = makelist(spec[0]) + makelist(spec.kwonlyargs)
@@ -111,27 +130,31 @@ if py3k:
 
     basestring = str
     unicode = str
-    json_loads = lambda s: json_lds(touni(s))
-    callable = lambda x: hasattr(x, '__call__')
+    def json_loads(s): return json_lds(touni(s))
+    def callable(x): return hasattr(x, '__call__')
     imap = map
 
     def _raise(*a):
         raise a[0](a[1]).with_traceback(a[2])
 else:  # 2.x
     warnings.warn("Python 2 support will be dropped in Bottle 0.14", DeprecationWarning)
-    import httplib
-    import thread
-    from urlparse import urljoin, SplitResult as UrlSplitResult
-    from urllib import urlencode, quote as urlquote, unquote as urlunquote
-    from Cookie import SimpleCookie, Morsel, CookieError
+    from collections import MutableMapping as DictMixin
+    from datetime import tzinfo
+    from imp import new_module
+    from inspect import getargspec
     from itertools import imap
+    from urllib import quote as urlquote
+    from urllib import unquote as urlunquote
+    from urllib import urlencode
+
+    import ConfigParser as configparser
     import cPickle as pickle
-    from imp import new_module
+    import httplib
+    import thread
+    from Cookie import CookieError, Morsel, SimpleCookie
     from StringIO import StringIO as BytesIO
-    import ConfigParser as configparser
-    from collections import MutableMapping as DictMixin
-    from inspect import getargspec
-    from datetime import tzinfo
+    from urlparse import SplitResult as UrlSplitResult
+    from urlparse import urljoin
 
     class _UTC(tzinfo):
         def utcoffset(self, dt): return timedelta(0)
@@ -164,7 +187,7 @@ def _stderr(*args):
     try:
         print(*args, file=sys.stderr)
     except (IOError, AttributeError):
-        pass # Some environments do not allow printing (mod_wsgi)
+        pass  # Some environments do not allow printing (mod_wsgi)
 
 
 # A bug in functools causes it to break if the wrapper is an instance method
@@ -209,17 +232,21 @@ class DictProperty(object):
         return self
 
     def __get__(self, obj, cls):
-        if obj is None: return self
+        if obj is None:
+            return self
         key, storage = self.key, getattr(obj, self.attr)
-        if key not in storage: storage[key] = self.getter(obj)
+        if key not in storage:
+            storage[key] = self.getter(obj)
         return storage[key]
 
     def __set__(self, obj, value):
-        if self.read_only: raise AttributeError("Read-Only property.")
+        if self.read_only:
+            raise AttributeError("Read-Only property.")
         getattr(obj, self.attr)[self.key] = value
 
     def __delete__(self, obj):
-        if self.read_only: raise AttributeError("Read-Only property.")
+        if self.read_only:
+            raise AttributeError("Read-Only property.")
         del getattr(obj, self.attr)[self.key]
 
 
@@ -233,7 +260,8 @@ class cached_property(object):
         self.func = func
 
     def __get__(self, obj, cls):
-        if obj is None: return self
+        if obj is None:
+            return self
         value = obj.__dict__[self.func.__name__] = self.func(obj)
         return value
 
@@ -339,9 +367,9 @@ class Router(object):
         self.filters[name] = func
 
     rule_syntax = re.compile('(\\\\*)'
-        '(?:(?::([a-zA-Z_][a-zA-Z_0-9]*)?()(?:#(.*?)#)?)'
-          '|(?:<([a-zA-Z_][a-zA-Z_0-9]*)?(?::([a-zA-Z_]*)'
-            '(?::((?:\\\\.|[^\\\\>])+)?)?)?>))')
+                             '(?:(?::([a-zA-Z_][a-zA-Z_0-9]*)?()(?:#(.*?)#)?)'
+                             '|(?:<([a-zA-Z_][a-zA-Z_0-9]*)?(?::([a-zA-Z_]*)'
+                             '(?::((?:\\\\.|[^\\\\>])+)?)?)?>))')
 
     def _itertokens(self, rule):
         offset, prefix = 0, ''
@@ -376,7 +404,8 @@ class Router(object):
         for key, mode, conf in self._itertokens(rule):
             if mode:
                 is_static = False
-                if mode == 'default': mode = self.default_filter
+                if mode == 'default':
+                    mode = self.default_filter
                 mask, in_filter, out_filter = self.filters[mode](conf)
                 if not key:
                     pattern += '(?:%s)' % mask
@@ -385,14 +414,16 @@ class Router(object):
                 else:
                     pattern += '(?P<%s>%s)' % (key, mask)
                     keys.append(key)
-                if in_filter: filters.append((key, in_filter))
+                if in_filter:
+                    filters.append((key, in_filter))
                 builder.append((key, out_filter or str))
             elif key:
                 pattern += re.escape(key)
                 builder.append((None, key))
 
         self.builder[rule] = builder
-        if name: self.builder[name] = builder
+        if name:
+            self.builder[name] = builder
 
         if is_static and not self.strict_order:
             self.static.setdefault(method, {})
@@ -548,11 +579,15 @@ class Route(object):
         """ Yield all Plugins affecting this route. """
         unique = set()
         for p in reversed(self.app.plugins + self.plugins):
-            if True in self.skiplist: break
+            if True in self.skiplist:
+                break
             name = getattr(p, 'name', False)
-            if name and (name in self.skiplist or name in unique): continue
-            if p in self.skiplist or type(p) in self.skiplist: continue
-            if name: unique.add(name)
+            if name and (name in self.skiplist or name in unique):
+                continue
+            if p in self.skiplist or type(p) in self.skiplist:
+                continue
+            if name:
+                unique.add(name)
             yield p
 
     def _make_callback(self):
@@ -815,7 +850,8 @@ class Bottle(object):
             applied to all routes of this application. A plugin may be a simple
             decorator or an object that implements the :class:`Plugin` API.
         """
-        if hasattr(plugin, 'setup'): plugin.setup(self)
+        if hasattr(plugin, 'setup'):
+            plugin.setup(self)
         if not callable(plugin) and not hasattr(plugin, 'apply'):
             raise TypeError("Plugins must be callable or implement .apply()")
         self.plugins.append(plugin)
@@ -830,20 +866,25 @@ class Bottle(object):
         removed, remove = [], plugin
         for i, plugin in list(enumerate(self.plugins))[::-1]:
             if remove is True or remove is plugin or remove is type(plugin) \
-            or getattr(plugin, 'name', True) == remove:
+                    or getattr(plugin, 'name', True) == remove:
                 removed.append(plugin)
                 del self.plugins[i]
-                if hasattr(plugin, 'close'): plugin.close()
-        if removed: self.reset()
+                if hasattr(plugin, 'close'):
+                    plugin.close()
+        if removed:
+            self.reset()
         return removed
 
     def reset(self, route=None):
         """ Reset all routes (force plugins to be re-applied) and clear all
             caches. If an ID or route object is given, only that specific route
             is affected. """
-        if route is None: routes = self.routes
-        elif isinstance(route, Route): routes = [route]
-        else: routes = [self.routes[route]]
+        if route is None:
+            routes = self.routes
+        elif isinstance(route, Route):
+            routes = [route]
+        else:
+            routes = [self.routes[route]]
         for route in routes:
             route.reset()
         if DEBUG:
@@ -854,7 +895,8 @@ class Bottle(object):
     def close(self):
         """ Close the application and all installed plugins. """
         for plugin in self.plugins:
-            if hasattr(plugin, 'close'): plugin.close()
+            if hasattr(plugin, 'close'):
+                plugin.close()
 
     def run(self, **kwargs):
         """ Calls :func:`run` with the same parameters. """
@@ -877,7 +919,8 @@ class Bottle(object):
             attribute."""
         self.routes.append(route)
         self.router.add(route.rule, route.method, route, name=route.name)
-        if DEBUG: route.prepare()
+        if DEBUG:
+            route.prepare()
 
     def route(self,
               path=None,
@@ -911,12 +954,14 @@ class Bottle(object):
             Any additional keyword arguments are stored as route-specific
             configuration and passed to plugins (see :meth:`Plugin.apply`).
         """
-        if callable(path): path, callback = None, path
+        if callable(path):
+            path, callback = None, path
         plugins = makelist(apply)
         skiplist = makelist(skip)
 
         def decorator(callback):
-            if isinstance(callback, basestring): callback = load(callback)
+            if isinstance(callback, basestring):
+                callback = load(callback)
             for rule in makelist(path) or yieldroutes(callback):
                 for verb in makelist(method):
                     verb = verb.upper()
@@ -965,7 +1010,8 @@ class Bottle(object):
         """
 
         def decorator(callback):
-            if isinstance(callback, basestring): callback = load(callback)
+            if isinstance(callback, basestring):
+                callback = load(callback)
             self.error_handler[int(code)] = callback
             return callback
 
@@ -984,7 +1030,7 @@ class Bottle(object):
         response.bind()
 
         try:
-            while True: # Remove in 0.14 together with RouteReset
+            while True:  # Remove in 0.14 together with RouteReset
                 out = None
                 try:
                     self.trigger_hook('before_request')
@@ -1014,7 +1060,8 @@ class Bottle(object):
         except (KeyboardInterrupt, SystemExit, MemoryError):
             raise
         except Exception as E:
-            if not self.catchall: raise
+            if not self.catchall:
+                raise
             stacktrace = format_exc()
             environ['wsgi.errors'].write(stacktrace)
             environ['wsgi.errors'].flush()
@@ -1038,7 +1085,7 @@ class Bottle(object):
             return []
         # Join lists of byte or unicode strings. Mixed lists are NOT supported
         if isinstance(out, (tuple, list))\
-        and isinstance(out[0], (bytes, unicode)):
+                and isinstance(out[0], (bytes, unicode)):
             out = out[0][0:0].join(out)  # b'abc'[0:0] -> b''
         # Encode unicode strings
         if isinstance(out, unicode):
@@ -1079,7 +1126,8 @@ class Bottle(object):
         except (KeyboardInterrupt, SystemExit, MemoryError):
             raise
         except Exception as error:
-            if not self.catchall: raise
+            if not self.catchall:
+                raise
             first = HTTPError(500, 'Unhandled exception', error, format_exc())
 
         # These are the inner types allowed in iterator or generator objects.
@@ -1088,7 +1136,7 @@ class Bottle(object):
         elif isinstance(first, bytes):
             new_iter = itertools.chain([first], iout)
         elif isinstance(first, unicode):
-            encoder = lambda x: x.encode(response.charset)
+            def encoder(x): return x.encode(response.charset)
             new_iter = imap(encoder, itertools.chain([first], iout))
         else:
             msg = 'Unsupported response type: %s' % type(first)
@@ -1103,8 +1151,9 @@ class Bottle(object):
             out = self._cast(self._handle(environ))
             # rfc2616 section 4.3
             if response._status_code in (100, 101, 204, 304)\
-            or environ['REQUEST_METHOD'] == 'HEAD':
-                if hasattr(out, 'close'): out.close()
+                    or environ['REQUEST_METHOD'] == 'HEAD':
+                if hasattr(out, 'close'):
+                    out.close()
                 out = []
             exc_info = environ.get('bottle.exc_info')
             if exc_info is not None:
@@ -1114,7 +1163,8 @@ class Bottle(object):
         except (KeyboardInterrupt, SystemExit, MemoryError):
             raise
         except Exception as E:
-            if not self.catchall: raise
+            if not self.catchall:
+                raise
             err = '<h1>Critical error while processing request: %s</h1>' \
                   % html_escape(environ.get('PATH_INFO', '/'))
             if DEBUG:
@@ -1303,7 +1353,8 @@ class BaseRequest(object):
         maxread = max(0, self.content_length)
         while maxread:
             part = read(min(maxread, bufsize))
-            if not part: break
+            if not part:
+                break
             yield part
             maxread -= len(part)
 
@@ -1316,20 +1367,24 @@ class BaseRequest(object):
             while header[-2:] != rn:
                 c = read(1)
                 header += c
-                if not c: raise err
-                if len(header) > bufsize: raise err
+                if not c:
+                    raise err
+                if len(header) > bufsize:
+                    raise err
             size, _, _ = header.partition(sem)
             try:
                 maxread = int(tonat(size.strip()), 16)
             except ValueError:
                 raise err
-            if maxread == 0: break
+            if maxread == 0:
+                break
             buff = bs
             while maxread > 0:
                 if not buff:
                     buff = read(min(maxread, bufsize))
                 part, buff = buff[:maxread], buff[maxread:]
-                if not part: raise err
+                if not part:
+                    raise err
                 yield part
                 maxread -= len(part)
             if read(2) != rn:
@@ -1408,15 +1463,15 @@ class BaseRequest(object):
         if not boundary:
             raise MultipartError("Invalid content type header, missing boundary")
         parser = _MultipartParser(self.body, boundary, self.content_length,
-            mem_limit=self.MEMFILE_MAX, memfile_limit=self.MEMFILE_MAX,
-            charset=charset)
+                                  mem_limit=self.MEMFILE_MAX, memfile_limit=self.MEMFILE_MAX,
+                                  charset=charset)
 
         for part in parser.parse():
             if not part.filename and part.is_buffered():
                 post[part.name] = tonat(part.value, 'utf8')
             else:
                 post[part.name] = FileUpload(part.file, part.name,
-                                            part.filename, part.headerlist)
+                                             part.filename, part.headerlist)
 
         return post
 
@@ -1436,7 +1491,7 @@ class BaseRequest(object):
             server. """
         env = self.environ
         http = env.get('HTTP_X_FORWARDED_PROTO') \
-             or env.get('wsgi.url_scheme', 'http')
+            or env.get('wsgi.url_scheme', 'http')
         host = env.get('HTTP_X_FORWARDED_HOST') or env.get('HTTP_HOST')
         if not host:
             # HTTP 1.1 requires a Host-header. This is for HTTP/1.0 clients.
@@ -1511,9 +1566,11 @@ class BaseRequest(object):
             the user field is looked up from the ``REMOTE_USER`` environ
             variable. On any errors, None is returned. """
         basic = parse_auth(self.environ.get('HTTP_AUTHORIZATION', ''))
-        if basic: return basic
+        if basic:
+            return basic
         ruser = self.environ.get('REMOTE_USER')
-        if ruser: return (ruser, None)
+        if ruser:
+            return (ruser, None)
         return None
 
     @property
@@ -1523,7 +1580,8 @@ class BaseRequest(object):
             work if all proxies support the ```X-Forwarded-For`` header. Note
             that this information can be forged by malicious clients. """
         proxy = self.environ.get('HTTP_X_FORWARDED_FOR')
-        if proxy: return [ip.strip() for ip in proxy.split(',')]
+        if proxy:
+            return [ip.strip() for ip in proxy.split(',')]
         remote = self.environ.get('REMOTE_ADDR')
         return [remote] if remote else []
 
@@ -1589,7 +1647,8 @@ class BaseRequest(object):
 
     def __setattr__(self, name, value):
         """ Define new attributes that are local to the bound request environment. """
-        if name == 'environ': return object.__setattr__(self, name, value)
+        if name == 'environ':
+            return object.__setattr__(self, name, value)
         key = 'bottle.request.ext.%s' % name
         if hasattr(self, name):
             raise AttributeError("Attribute already defined: %s" % name)
@@ -1622,7 +1681,8 @@ class HeaderProperty(object):
         self.__doc__ = 'Current value of the %r header.' % name.title()
 
     def __get__(self, obj, _):
-        if obj is None: return self
+        if obj is None:
+            return self
         value = obj.get_header(self.name, self.default)
         return self.reader(value) if self.reader else value
 
@@ -1649,8 +1709,8 @@ class BaseResponse(object):
     bad_headers = {
         204: frozenset(('Content-Type', 'Content-Length')),
         304: frozenset(('Allow', 'Content-Encoding', 'Content-Language',
-                  'Content-Length', 'Content-Range', 'Content-Type',
-                  'Content-Md5', 'Last-Modified'))
+                        'Content-Length', 'Content-Range', 'Content-Type',
+                        'Content-Md5', 'Last-Modified'))
     }
 
     def __init__(self, body='', status=None, headers=None, **more_headers):
@@ -1686,9 +1746,9 @@ class BaseResponse(object):
         copy._headers = dict((k, v[:]) for (k, v) in self._headers.items())
         if self._cookies:
             cookies = copy._cookies = SimpleCookie()
-            for k,v in self._cookies.items():
+            for k, v in self._cookies.items():
                 cookies[k] = v.value
-                cookies[k].update(v) # also copy cookie attributes
+                cookies[k].update(v)  # also copy cookie attributes
         return copy
 
     def __iter__(self):
@@ -1879,13 +1939,13 @@ class BaseResponse(object):
         self._cookies[name] = value
 
         for key, value in options.items():
-            if key in ('max_age', 'maxage'): # 'maxage' variant added in 0.13
+            if key in ('max_age', 'maxage'):  # 'maxage' variant added in 0.13
                 key = 'max-age'
                 if isinstance(value, timedelta):
                     value = value.seconds + value.days * 24 * 3600
             if key == 'expires':
                 value = http_date(value)
-            if key in ('same_site', 'samesite'): # 'samesite' variant added in 0.13
+            if key in ('same_site', 'samesite'):  # 'samesite' variant added in 0.13
                 key, value = 'samesite', (value or "none").lower()
                 if value not in ('lax', 'strict', 'none'):
                     raise CookieError("Invalid value for SameSite")
@@ -2005,19 +2065,20 @@ class JSONPlugin(object):
 
     def setup(self, app):
         app.config._define('json.enable', default=True, validate=bool,
-                          help="Enable or disable automatic dict->json filter.")
+                           help="Enable or disable automatic dict->json filter.")
         app.config._define('json.ascii', default=False, validate=bool,
-                          help="Use only 7-bit ASCII characters in output.")
+                           help="Use only 7-bit ASCII characters in output.")
         app.config._define('json.indent', default=True, validate=bool,
-                          help="Add whitespace to make json more readable.")
+                           help="Add whitespace to make json more readable.")
         app.config._define('json.dump_func', default=None,
-                          help="If defined, use this function to transform"
-                               " dict into json. The other options no longer"
-                               " apply.")
+                           help="If defined, use this function to transform"
+                           " dict into json. The other options no longer"
+                           " apply.")
 
     def apply(self, callback, route):
         dumps = self.json_dumps
-        if not self.json_dumps: return callback
+        if not self.json_dumps:
+            return callback
 
         @functools.wraps(callback)
         def wrapper(*a, **ka):
@@ -2077,24 +2138,29 @@ class _ImportRedirect(object):
         sys.meta_path.append(self)
 
     def find_spec(self, fullname, path, target=None):
-        if '.' not in fullname: return
-        if fullname.rsplit('.', 1)[0] != self.name: return
+        if '.' not in fullname:
+            return
+        if fullname.rsplit('.', 1)[0] != self.name:
+            return
         from importlib.util import spec_from_loader
         return spec_from_loader(fullname, self)
 
     def find_module(self, fullname, path=None):
-        if '.' not in fullname: return
-        if fullname.rsplit('.', 1)[0] != self.name: return
+        if '.' not in fullname:
+            return
+        if fullname.rsplit('.', 1)[0] != self.name:
+            return
         return self
 
     def create_module(self, spec):
         return self.load_module(spec.name)
 
     def exec_module(self, module):
-        pass # This probably breaks importlib.reload() :/
+        pass  # This probably breaks importlib.reload() :/
 
     def load_module(self, fullname):
-        if fullname in sys.modules: return sys.modules[fullname]
+        if fullname in sys.modules:
+            return sys.modules[fullname]
         modname = fullname.rsplit('.', 1)[1]
         realname = self.impmask % modname
         __import__(realname)
@@ -2263,7 +2329,8 @@ class HeaderDict(MultiDict):
 
     def __init__(self, *a, **ka):
         self.dict = {}
-        if a or ka: self.update(*a, **ka)
+        if a or ka:
+            self.update(*a, **ka)
 
     def __contains__(self, key):
         return _hkey(key) in self.dict
@@ -2354,6 +2421,7 @@ class WSGIHeaderDict(DictMixin):
     def __contains__(self, key):
         return self._ekey(key) in self.environ
 
+
 _UNSET = object()
 
 class ConfigDict(dict):
@@ -2535,7 +2603,7 @@ class ConfigDict(dict):
 
     def meta_set(self, key, metafield, value):
         """ Set the meta field for a key to a new value.
-        
+
             Meta-fields are shared between all members of an overlay tree.
         """
         self._meta.setdefault(key, {})[metafield] = value
@@ -2595,8 +2663,6 @@ class ConfigDict(dict):
         return overlay
 
 
-
-
 class AppStack(list):
     """ A stack-like list. Calling it returns the head of the stack. """
 
@@ -2624,7 +2690,8 @@ class WSGIFileWrapper(object):
     def __init__(self, fp, buffer_size=1024 * 64):
         self.fp, self.buffer_size = fp, buffer_size
         for attr in 'fileno', 'close', 'read', 'readlines', 'tell', 'seek':
-            if hasattr(fp, attr): setattr(self, attr, getattr(fp, attr))
+            if hasattr(fp, attr):
+                setattr(self, attr, getattr(fp, attr))
 
     def __iter__(self):
         buff, read = self.buffer_size, self.read
@@ -2706,11 +2773,14 @@ class ResourceManager(object):
         search = self.path[:]
         while search:
             path = search.pop()
-            if not os.path.isdir(path): continue
+            if not os.path.isdir(path):
+                continue
             for name in os.listdir(path):
                 full = os.path.join(path, name)
-                if os.path.isdir(full): search.append(full)
-                else: yield full
+                if os.path.isdir(full):
+                    search.append(full)
+                else:
+                    yield full
 
     def lookup(self, name):
         """ Search for a resource and return an absolute file path, or `None`.
@@ -2732,7 +2802,8 @@ class ResourceManager(object):
     def open(self, name, mode='r', *args, **kwargs):
         """ Find a resource and return a file object, or raise IOError. """
         fname = self.lookup(name)
-        if not fname: raise IOError("Resource %r not found." % name)
+        if not fname:
+            raise IOError("Resource %r not found." % name)
         return self.opener(fname, mode=mode, *args, **kwargs)
 
 
@@ -2779,7 +2850,8 @@ class FileUpload(object):
         read, write, offset = self.file.read, fp.write, self.file.tell()
         while 1:
             buf = read(chunk_size)
-            if not buf: break
+            if not buf:
+                break
             write(buf)
         self.file.seek(offset)
 
@@ -2889,11 +2961,11 @@ def static_file(filename, root,
         mimetype, encoding = mimetypes.guess_type(name)
         if encoding == 'gzip':
             mimetype = 'application/gzip'
-        elif encoding: # e.g. bzip2 -> application/x-bzip2
+        elif encoding:  # e.g. bzip2 -> application/x-bzip2
             mimetype = 'application/x-' + encoding
 
     if charset and mimetype and 'charset=' not in mimetype \
-        and (mimetype[:5] == 'text/' or mimetype == 'application/javascript'):
+            and (mimetype[:5] == 'text/' or mimetype == 'application/javascript'):
         mimetype += '; charset=%s' % charset
 
     if mimetype:
@@ -2903,7 +2975,7 @@ def static_file(filename, root,
         download = os.path.basename(filename)
 
     if download:
-        download = download.replace('"','')
+        download = download.replace('"', '')
         headers['Content-Disposition'] = 'attachment; filename="%s"' % download
 
     stats = os.stat(filename)
@@ -2940,7 +3012,8 @@ def static_file(filename, root,
         rlen = end - offset
         headers["Content-Range"] = "bytes %d-%d/%d" % (offset, end - 1, clen)
         headers["Content-Length"] = str(rlen)
-        if body: body = _closeiter(_rangeiter(body, offset, rlen), body.close)
+        if body:
+            body = _closeiter(_rangeiter(body, offset, rlen), body.close)
         return HTTPResponse(body, status=206, **headers)
     return HTTPResponse(body, **headers)
 
@@ -2953,7 +3026,8 @@ def debug(mode=True):
     """ Change the debug level.
     There is only one debug level supported at the moment."""
     global DEBUG
-    if mode: warnings.simplefilter('default')
+    if mode:
+        warnings.simplefilter('default')
     DEBUG = bool(mode)
 
 
@@ -2996,7 +3070,8 @@ def parse_auth(header):
 def parse_range_header(header, maxlen=0):
     """ Yield (start, end) ranges parsed from a HTTP Range header. Skip
         unsatisfiable ranges. The end index is non-inclusive."""
-    if not header or header[:6] != 'bytes=': return
+    if not header or header[:6] != 'bytes=':
+        return
     ranges = [r.split('-', 1) for r in header[6:].split(',') if '-' in r]
     for start, end in ranges:
         try:
@@ -3051,9 +3126,11 @@ def _parse_http_header(h):
 def _parse_qsl(qs):
     r = []
     for pair in qs.split('&'):
-        if not pair: continue
+        if not pair:
+            continue
         nv = pair.split('=', 1)
-        if len(nv) != 2: nv.append('')
+        if len(nv) != 2:
+            nv.append('')
         key = urlunquote(nv[0].replace('+', ' '))
         value = urlunquote(nv[1].replace('+', ' '))
         r.append((key, value))
@@ -3107,7 +3184,7 @@ def html_escape(string):
 def html_quote(string):
     """ Escape and quote a string to be used as an HTTP attribute."""
     return '"%s"' % html_escape(string).replace('\n', '&#10;')\
-                    .replace('\r', '&#13;').replace('\t', '&#9;')
+        .replace('\r', '&#13;').replace('\t', '&#9;')
 
 
 def yieldroutes(func):
@@ -3139,11 +3216,14 @@ def path_shift(script_name, path_info, shift=1):
         :param shift: The number of path fragments to shift. May be negative to
           change the shift direction. (default: 1)
     """
-    if shift == 0: return script_name, path_info
+    if shift == 0:
+        return script_name, path_info
     pathlist = path_info.strip('/').split('/')
     scriptlist = script_name.strip('/').split('/')
-    if pathlist and pathlist[0] == '': pathlist = []
-    if scriptlist and scriptlist[0] == '': scriptlist = []
+    if pathlist and pathlist[0] == '':
+        pathlist = []
+    if scriptlist and scriptlist[0] == '':
+        scriptlist = []
     if 0 < shift <= len(pathlist):
         moved = pathlist[:shift]
         scriptlist = scriptlist + moved
@@ -3157,7 +3237,8 @@ def path_shift(script_name, path_info, shift=1):
         raise AssertionError("Cannot shift. Nothing left from %s" % empty)
     new_script_name = '/' + '/'.join(scriptlist)
     new_path_info = '/' + '/'.join(pathlist)
-    if path_info.endswith('/') and pathlist: new_path_info += '/'
+    if path_info.endswith('/') and pathlist:
+        new_path_info += '/'
     return new_script_name, new_path_info
 
 
@@ -3194,18 +3275,18 @@ def make_default_app_wrapper(name):
     return wrapper
 
 
-route     = make_default_app_wrapper('route')
-get       = make_default_app_wrapper('get')
-post      = make_default_app_wrapper('post')
-put       = make_default_app_wrapper('put')
-delete    = make_default_app_wrapper('delete')
-patch     = make_default_app_wrapper('patch')
-error     = make_default_app_wrapper('error')
-mount     = make_default_app_wrapper('mount')
-hook      = make_default_app_wrapper('hook')
-install   = make_default_app_wrapper('install')
+route = make_default_app_wrapper('route')
+get = make_default_app_wrapper('get')
+post = make_default_app_wrapper('post')
+put = make_default_app_wrapper('put')
+delete = make_default_app_wrapper('delete')
+patch = make_default_app_wrapper('patch')
+error = make_default_app_wrapper('error')
+mount = make_default_app_wrapper('mount')
+hook = make_default_app_wrapper('hook')
+install = make_default_app_wrapper('install')
 uninstall = make_default_app_wrapper('uninstall')
-url       = make_default_app_wrapper('get_url')
+url = make_default_app_wrapper('get_url')
 
 
 ###############################################################################
@@ -3276,7 +3357,7 @@ class _MultipartParser(object):
                 if i >= 0:
                     yield chunk[scanpos:i], b'\r\n'
                     scanpos = i + 2
-                else: # CRLF not found
+                else:  # CRLF not found
                     partial = chunk[scanpos:] if scanpos else chunk
                     break
 
@@ -3418,7 +3499,7 @@ class _MultipartPart(object):
         if "filename" in self.options:
             self.filename = self.options.get("filename")
             if self.filename[1:3] == ":\\" or self.filename[:2] == "\\\\":
-                self.filename = self.filename.split("\\")[-1] # ie6 bug
+                self.filename = self.filename.split("\\")[-1]  # ie6 bug
 
         self.content_type, options = _parse_http_header(content_type)[0] if content_type else (None, {})
         self.charset = options.get("charset") or self.charset
@@ -3477,7 +3558,7 @@ class ServerAdapter(object):
 
     def __repr__(self):
         args = ', '.join('%s=%s' % (k, repr(v))
-                          for k, v in self.options.items())
+                         for k, v in self.options.items())
         return "%s(%s)" % (self.__class__.__name__, args)
 
 
@@ -3503,9 +3584,8 @@ class FlupFCGIServer(ServerAdapter):
 
 class WSGIRefServer(ServerAdapter):
     def run(self, app):  # pragma: no cover
-        from wsgiref.simple_server import make_server
-        from wsgiref.simple_server import WSGIRequestHandler, WSGIServer
         import socket
+        from wsgiref.simple_server import WSGIRequestHandler, WSGIServer, make_server
 
         class FixedHandler(WSGIRequestHandler):
             def address_string(self):  # Prevent reverse DNS lookups please.
@@ -3539,7 +3619,7 @@ class CherryPyServer(ServerAdapter):
         depr(0, 13, "The wsgi server part of cherrypy was split into a new "
                     "project called 'cheroot'.", "Use the 'cheroot' server "
                     "adapter instead of cherrypy.")
-        from cherrypy import wsgiserver # This will fail for CherryPy >= 9
+        from cherrypy import wsgiserver  # This will fail for CherryPy >= 9
 
         self.options['bind_addr'] = (self.host, self.port)
         self.options['wsgi_app'] = handler
@@ -3564,7 +3644,7 @@ class CherryPyServer(ServerAdapter):
 
 
 class CherootServer(ServerAdapter):
-    def run(self, handler): # pragma: no cover
+    def run(self, handler):  # pragma: no cover
         from cheroot import wsgi
         from cheroot.ssl import builtin
         self.options['bind_addr'] = (self.host, self.port)
@@ -3575,7 +3655,7 @@ class CherootServer(ServerAdapter):
         server = wsgi.Server(**self.options)
         if certfile and keyfile:
             server.ssl_adapter = builtin.BuiltinSSLAdapter(
-                    certfile, keyfile, chainfile)
+                certfile, keyfile, chainfile)
         try:
             server.start()
         finally:
@@ -3635,7 +3715,9 @@ class TornadoServer(ServerAdapter):
     """ The super hyped asynchronous server by facebook. Untested. """
 
     def run(self, handler):  # pragma: no cover
-        import tornado.wsgi, tornado.httpserver, tornado.ioloop
+        import tornado.httpserver
+        import tornado.ioloop
+        import tornado.wsgi
         container = tornado.wsgi.WSGIContainer(handler)
         server = tornado.httpserver.HTTPServer(container)
         server.listen(port=self.port, address=self.host)
@@ -3650,6 +3732,7 @@ class AppEngineServer(ServerAdapter):
         depr(0, 13, "AppEngineServer no longer required",
              "Configure your application directly in your app.yaml")
         from google.appengine.ext.webapp import util
+
         # A main() function in the handler script enables 'App Caching'.
         # Lets makes sure it is there. This _really_ improves performance.
         module = sys.modules.get('__main__')
@@ -3662,9 +3745,9 @@ class TwistedServer(ServerAdapter):
     """ Untested. """
 
     def run(self, handler):
-        from twisted.web import server, wsgi
-        from twisted.python.threadpool import ThreadPool
         from twisted.internet import reactor
+        from twisted.python.threadpool import ThreadPool
+        from twisted.web import server, wsgi
         thread_pool = ThreadPool()
         thread_pool.start()
         reactor.addSystemEventTrigger('after', 'shutdown', thread_pool.stop)
@@ -3691,7 +3774,7 @@ class GeventServer(ServerAdapter):
     """
 
     def run(self, handler):
-        from gevent import pywsgi, local
+        from gevent import local, pywsgi
         if not isinstance(threading.local(), local.local):
             msg = "Bottle requires gevent.monkey.patch_all() (before import)"
             raise RuntimeError(msg)
@@ -3740,7 +3823,7 @@ class EventletServer(ServerAdapter):
     """
 
     def run(self, handler):
-        from eventlet import wsgi, listen, patcher
+        from eventlet import listen, patcher, wsgi
         if not patcher.is_monkey_patched(os):
             msg = "Bottle requires eventlet.monkey_patch() (before import)"
             raise RuntimeError(msg)
@@ -3768,6 +3851,7 @@ class BjoernServer(ServerAdapter):
 
 class AsyncioServerAdapter(ServerAdapter):
     """ Extend ServerAdapter for adding custom event loop """
+
     def get_event_loop(self):
         pass
 
@@ -3783,6 +3867,7 @@ class AiohttpServer(AsyncioServerAdapter):
 
     def run(self, handler):
         import asyncio
+
         from aiohttp_wsgi.wsgi import serve
         self.loop = self.get_event_loop()
         asyncio.set_event_loop(self.loop)
@@ -3798,6 +3883,7 @@ class AiohttpUVLoopServer(AiohttpServer):
     """uvloop
        https://github.com/MagicStack/uvloop
     """
+
     def get_event_loop(self):
         import uvloop
         return uvloop.new_event_loop()
@@ -3855,9 +3941,12 @@ def load(target, **namespace):
         local variables. Example: ``import_string('re:compile(x)', x='[a-z]')``
     """
     module, target = target.split(":", 1) if ':' in target else (target, None)
-    if module not in sys.modules: __import__(module)
-    if not target: return sys.modules[module]
-    if target.isalnum(): return getattr(sys.modules[module], target)
+    if module not in sys.modules:
+        __import__(module)
+    if not target:
+        return sys.modules[module]
+    if target.isalnum():
+        return getattr(sys.modules[module], target)
     package_name = module.split('.')[0]
     namespace[package_name] = sys.modules[package_name]
     return eval('%s.%s' % (module, target), namespace)
@@ -3907,7 +3996,8 @@ def run(app=None,
         :param quiet: Suppress output to stdout and stderr? (default: False)
         :param options: Options passed to the server adapter.
      """
-    if NORUN: return
+    if NORUN:
+        return
     if reloader and not os.environ.get('BOTTLE_CHILD'):
         import subprocess
         fd, lockfile = tempfile.mkstemp(prefix='bottle.', suffix='.lock')
@@ -3938,7 +4028,8 @@ def run(app=None,
         return
 
     try:
-        if debug is not None: _debug(debug)
+        if debug is not None:
+            _debug(debug)
         app = app or default_app()
         if isinstance(app, basestring):
             app = load_app(app)
@@ -3987,7 +4078,8 @@ def run(app=None,
     except (SystemExit, MemoryError):
         raise
     except:
-        if not reloader: raise
+        if not reloader:
+            raise
         if not getattr(server, 'quiet', quiet):
             print_exc()
         time.sleep(interval)
@@ -4007,17 +4099,19 @@ class FileCheckerThread(threading.Thread):
 
     def run(self):
         exists = os.path.exists
-        mtime = lambda p: os.stat(p).st_mtime
+        def mtime(p): return os.stat(p).st_mtime
         files = dict()
 
         for module in list(sys.modules.values()):
             path = getattr(module, '__file__', '') or ''
-            if path[-4:] in ('.pyo', '.pyc'): path = path[:-1]
-            if path and exists(path): files[path] = mtime(path)
+            if path[-4:] in ('.pyo', '.pyc'):
+                path = path[:-1]
+            if path and exists(path):
+                files[path] = mtime(path)
 
         while not self.status:
             if not exists(self.lockfile)\
-            or mtime(self.lockfile) < time.time() - self.interval - 5:
+                    or mtime(self.lockfile) < time.time() - self.interval - 5:
                 self.status = 'error'
                 thread.interrupt_main()
             for path, lmtime in list(files.items()):
@@ -4031,7 +4125,8 @@ class FileCheckerThread(threading.Thread):
         self.start()
 
     def __exit__(self, exc_type, *_):
-        if not self.status: self.status = 'exit'  # silent exit
+        if not self.status:
+            self.status = 'exit'  # silent exit
         self.join()
         return exc_type is not None and issubclass(exc_type, KeyboardInterrupt)
 
@@ -4047,8 +4142,8 @@ class TemplateError(BottleException):
 class BaseTemplate(object):
     """ Base class and minimal API for template adapters """
     extensions = ['tpl', 'html', 'thtml', 'stpl']
-    settings = {}  #used in prepare()
-    defaults = {}  #used in render()
+    settings = {}  # used in prepare()
+    defaults = {}  # used in render()
 
     def __init__(self,
                  source=None,
@@ -4094,8 +4189,10 @@ class BaseTemplate(object):
         for spath in lookup:
             spath = os.path.abspath(spath) + os.sep
             fname = os.path.abspath(os.path.join(spath, name))
-            if not fname.startswith(spath): continue
-            if os.path.isfile(fname): return fname
+            if not fname.startswith(spath):
+                continue
+            if os.path.isfile(fname):
+                return fname
             for ext in cls.extensions:
                 if os.path.isfile('%s.%s' % (fname, ext)):
                     return '%s.%s' % (fname, ext)
@@ -4128,8 +4225,8 @@ class BaseTemplate(object):
 
 class MakoTemplate(BaseTemplate):
     def prepare(self, **options):
-        from mako.template import Template
         from mako.lookup import TemplateLookup
+        from mako.template import Template
         options.update({'input_encoding': self.encoding})
         options.setdefault('format_exceptions', bool(DEBUG))
         lookup = TemplateLookup(directories=self.lookup, **options)
@@ -4173,9 +4270,12 @@ class Jinja2Template(BaseTemplate):
     def prepare(self, filters=None, tests=None, globals={}, **kwargs):
         from jinja2 import Environment, FunctionLoader
         self.env = Environment(loader=FunctionLoader(self.loader), **kwargs)
-        if filters: self.env.filters.update(filters)
-        if tests: self.env.tests.update(tests)
-        if globals: self.env.globals.update(globals)
+        if filters:
+            self.env.filters.update(filters)
+        if tests:
+            self.env.tests.update(tests)
+        if globals:
+            self.env.globals.update(globals)
         if self.source:
             self.tpl = self.env.from_string(self.source)
         else:
@@ -4193,7 +4293,8 @@ class Jinja2Template(BaseTemplate):
             fname = name
         else:
             fname = self.search(name, self.lookup)
-        if not fname: return
+        if not fname:
+            return
         with open(fname, "rb") as f:
             return (f.read().decode(self.encoding), fname, lambda: False)
 
@@ -4258,7 +4359,7 @@ class SimpleTemplate(BaseTemplate):
         exec(self.co, env)
         if env.get('_rebase'):
             subtpl, rargs = env.pop('_rebase')
-            rargs['base'] = ''.join(_stdout)  #copy stdout
+            rargs['base'] = ''.join(_stdout)  # copy stdout
             del _stdout[:]  # clear stdout
             return self._include(env, subtpl, **rargs)
         return env
@@ -4332,7 +4433,6 @@ class StplParser(object):
     _re_tok = '(?mx)' + _re_tok
     _re_inl = '(?mx)' + _re_inl
 
-
     default_syntax = '<% %> % {{ }}'
 
     def __init__(self, source, syntax=None, encoding='utf8'):
@@ -4362,7 +4462,8 @@ class StplParser(object):
     syntax = property(get_syntax, set_syntax)
 
     def translate(self):
-        if self.offset: raise RuntimeError('Parser is a one time instance.')
+        if self.offset:
+            raise RuntimeError('Parser is a one time instance.')
         while True:
             m = self.re_split.search(self.source, pos=self.offset)
             if m:
@@ -4423,8 +4524,10 @@ class StplParser(object):
                 code_line = _blk2
                 self.indent_mod -= 1
             elif _cend:  # The end-code-block template token (usually '%>')
-                if multiline: multiline = False
-                else: code_line += _cend
+                if multiline:
+                    multiline = False
+                else:
+                    code_line += _cend
             elif _end:
                 self.indent -= 1
                 self.indent_mod += 1
@@ -4440,19 +4543,23 @@ class StplParser(object):
     def flush_text(self):
         text = ''.join(self.text_buffer)
         del self.text_buffer[:]
-        if not text: return
+        if not text:
+            return
         parts, pos, nl = [], 0, '\\\n' + '  ' * self.indent
         for m in self.re_inl.finditer(text):
             prefix, pos = text[pos:m.start()], m.end()
             if prefix:
                 parts.append(nl.join(map(repr, prefix.splitlines(True))))
-            if prefix.endswith('\n'): parts[-1] += nl
+            if prefix.endswith('\n'):
+                parts[-1] += nl
             parts.append(self.process_inline(m.group(1).strip()))
         if pos < len(text):
             prefix = text[pos:]
             lines = prefix.splitlines(True)
-            if lines[-1].endswith('\\\\\n'): lines[-1] = lines[-1][:-3]
-            elif lines[-1].endswith('\\\\\r\n'): lines[-1] = lines[-1][:-4]
+            if lines[-1].endswith('\\\\\n'):
+                lines[-1] = lines[-1][:-3]
+            elif lines[-1].endswith('\\\\\r\n'):
+                lines[-1] = lines[-1][:-4]
             parts.append(nl.join(map(repr, lines)))
         code = '_printlist((%s,))' % ', '.join(parts)
         self.lineno += code.count('\n') + 1
@@ -4460,7 +4567,8 @@ class StplParser(object):
 
     @staticmethod
     def process_inline(chunk):
-        if chunk[0] == '!': return '_str(%s)' % chunk[1:]
+        if chunk[0] == '!':
+            return '_str(%s)' % chunk[1:]
         return '_escape(%s)' % chunk
 
     def write_code(self, line, comment=''):
@@ -4486,7 +4594,8 @@ def template(*args, **kwargs):
         settings = kwargs.pop('template_settings', {})
         if isinstance(tpl, adapter):
             TEMPLATES[tplid] = tpl
-            if settings: TEMPLATES[tplid].prepare(**settings)
+            if settings:
+                TEMPLATES[tplid].prepare(**settings)
         elif "\n" in tpl or "{" in tpl or "%" in tpl or '$' in tpl:
             TEMPLATES[tplid] = adapter(source=tpl, lookup=lookup, **settings)
         else:
@@ -4550,7 +4659,7 @@ HTTP_CODES[418] = "I'm a teapot"  # RFC 2324
 HTTP_CODES[428] = "Precondition Required"
 HTTP_CODES[429] = "Too Many Requests"
 HTTP_CODES[431] = "Request Header Fields Too Large"
-HTTP_CODES[451] = "Unavailable For Legal Reasons" # RFC 7725
+HTTP_CODES[451] = "Unavailable For Legal Reasons"  # RFC 7725
 HTTP_CODES[511] = "Network Authentication Required"
 _HTTP_STATUS_LINES = dict((k, '%d %s' % (k, v))
                           for (k, v) in HTTP_CODES.items())
@@ -4614,7 +4723,7 @@ apps = app = default_app = AppStack()
 
 #: A virtual package that redirects import statements.
 #: Example: ``import bottle.ext.sqlite`` actually imports `bottle_sqlite`.
-ext = _ImportRedirect('bottle.ext' if __name__ == '__main__' else
+ext = _ImportRedirect('bottle.ext' if __name__ == "__main__" else
                       __name__ + ".ext", 'bottle_%s').module
 
 
@@ -4676,5 +4785,5 @@ def main():
     _main(sys.argv)
 
 
-if __name__ == '__main__':  # pragma: no coverage
+if __name__ == "__main__":  # pragma: no coverage
     main()

{ezkit-1.11.14 → ezkit-1.11.15}/ezKit/utils.py

@@ -1,6 +1,8 @@
 """Utils"""
 import csv
 import hashlib
+import importlib
+import importlib.util
 import json
 import os
 import re
@@ -17,9 +19,11 @@ from typing import Any, Callable
 from urllib.parse import ParseResult, urlparse
 from uuid import uuid4
 
-import markdown
 from loguru import logger
 
+if importlib.util.find_spec("markdown"):
+    import markdown  # type: ignore
+
 # --------------------------------------------------------------------------------------------------
 
 
@@ -1478,7 +1482,9 @@ def markdown_to_html(markdown_file: str, html_file: str, title: str) -> bool:
 
         # 将 Markdown 转换为 HTML
         logger.info(f"{info} [将 Markdown 转换为 HTML]")
-        html_body = markdown.markdown(markdown_content, extensions=['tables'])
+        # pylint: disable=E0606
+        html_body = markdown.markdown(markdown_content, extensions=['tables'])  # type: ignore
+        # pylint: enable=E0606
 
         # 构造完整的 HTML
         logger.info(f"{info} [构造完整的 HTML]")

{ezkit-1.11.14 → ezkit-1.11.15/ezKit.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: ezKit
-Version: 1.11.14
+Version: 1.11.15
 Summary: Easy Kit
 Author: septvean
 Author-email: septvean@gmail.com

{ezkit-1.11.14 → ezkit-1.11.15}/setup.py

@@ -3,7 +3,7 @@ from setuptools import find_packages, setup
 
 setup(
     name='ezKit',
-    version='1.11.14',
+    version='1.11.15',
     author='septvean',
     author_email='septvean@gmail.com',
     description='Easy Kit',