Файловый менеджер - Редактировать - /var/www/html/support.zip
Ðазад
PK ! m�oin n testresult.pynu �[��� '''Test runner and result class for the regression test suite. ''' import functools import io import sys import time import traceback import unittest class RegressionTestResult(unittest.TextTestResult): USE_XML = False def __init__(self, stream, descriptions, verbosity): super().__init__(stream=stream, descriptions=descriptions, verbosity=2 if verbosity else 0) self.buffer = True if self.USE_XML: from xml.etree import ElementTree as ET from datetime import datetime self.__ET = ET self.__suite = ET.Element('testsuite') self.__suite.set('start', datetime.utcnow().isoformat(' ')) self.__e = None self.__start_time = None @classmethod def __getId(cls, test): try: test_id = test.id except AttributeError: return str(test) try: return test_id() except TypeError: return str(test_id) return repr(test) def startTest(self, test): super().startTest(test) if self.USE_XML: self.__e = e = self.__ET.SubElement(self.__suite, 'testcase') self.__start_time = time.perf_counter() def _add_result(self, test, capture=False, **args): if not self.USE_XML: return e = self.__e self.__e = None if e is None: return ET = self.__ET e.set('name', args.pop('name', self.__getId(test))) e.set('status', args.pop('status', 'run')) e.set('result', args.pop('result', 'completed')) if self.__start_time: e.set('time', f'{time.perf_counter() - self.__start_time:0.6f}') if capture: if self._stdout_buffer is not None: stdout = self._stdout_buffer.getvalue().rstrip() ET.SubElement(e, 'system-out').text = stdout if self._stderr_buffer is not None: stderr = self._stderr_buffer.getvalue().rstrip() ET.SubElement(e, 'system-err').text = stderr for k, v in args.items(): if not k or not v: continue e2 = ET.SubElement(e, k) if hasattr(v, 'items'): for k2, v2 in v.items(): if k2: e2.set(k2, str(v2)) else: e2.text = str(v2) else: e2.text = str(v) @classmethod def __makeErrorDict(cls, err_type, err_value, err_tb): if isinstance(err_type, type): if err_type.__module__ == 'builtins': typename = err_type.__name__ else: typename = f'{err_type.__module__}.{err_type.__name__}' else: typename = repr(err_type) msg = traceback.format_exception(err_type, err_value, None) tb = traceback.format_exception(err_type, err_value, err_tb) return { 'type': typename, 'message': ''.join(msg), '': ''.join(tb), } def addError(self, test, err): self._add_result(test, True, error=self.__makeErrorDict(*err)) super().addError(test, err) def addExpectedFailure(self, test, err): self._add_result(test, True, output=self.__makeErrorDict(*err)) super().addExpectedFailure(test, err) def addFailure(self, test, err): self._add_result(test, True, failure=self.__makeErrorDict(*err)) super().addFailure(test, err) def addSkip(self, test, reason): self._add_result(test, skipped=reason) super().addSkip(test, reason) def addSuccess(self, test): self._add_result(test) super().addSuccess(test) def addUnexpectedSuccess(self, test): self._add_result(test, outcome='UNEXPECTED_SUCCESS') super().addUnexpectedSuccess(test) def get_xml_element(self): if not self.USE_XML: raise ValueError("USE_XML is false") e = self.__suite e.set('tests', str(self.testsRun)) e.set('errors', str(len(self.errors))) e.set('failures', str(len(self.failures))) return e class QuietRegressionTestRunner: def __init__(self, stream, buffer=False): self.result = RegressionTestResult(stream, None, 0) self.result.buffer = buffer def run(self, test): test(self.result) return self.result def get_test_runner_class(verbosity, buffer=False): if verbosity: return functools.partial(unittest.TextTestRunner, resultclass=RegressionTestResult, buffer=buffer, verbosity=verbosity) return functools.partial(QuietRegressionTestRunner, buffer=buffer) def get_test_runner(stream, verbosity, capture_output=False): return get_test_runner_class(verbosity, capture_output)(stream) if __name__ == '__main__': import xml.etree.ElementTree as ET RegressionTestResult.USE_XML = True class TestTests(unittest.TestCase): def test_pass(self): pass def test_pass_slow(self): time.sleep(1.0) def test_fail(self): print('stdout', file=sys.stdout) print('stderr', file=sys.stderr) self.fail('failure message') def test_error(self): print('stdout', file=sys.stdout) print('stderr', file=sys.stderr) raise RuntimeError('error message') suite = unittest.TestSuite() suite.addTest(unittest.makeSuite(TestTests)) stream = io.StringIO() runner_cls = get_test_runner_class(sum(a == '-v' for a in sys.argv)) runner = runner_cls(sys.stdout) result = runner.run(suite) print('Output:', stream.getvalue()) print('XML: ', end='') for s in ET.tostringlist(result.get_xml_element()): print(s.decode(), end='') print() PK ! %3z�� � logging_helper.pynu �[��� import logging.handlers class TestHandler(logging.handlers.BufferingHandler): def __init__(self, matcher): # BufferingHandler takes a "capacity" argument # so as to know when to flush. As we're overriding # shouldFlush anyway, we can set a capacity of zero. # You can call flush() manually to clear out the # buffer. logging.handlers.BufferingHandler.__init__(self, 0) self.matcher = matcher def shouldFlush(self): return False def emit(self, record): self.format(record) self.buffer.append(record.__dict__) def matches(self, **kwargs): """ Look for a saved dict whose keys/values match the supplied arguments. """ result = False for d in self.buffer: if self.matcher.matches(d, **kwargs): result = True break return result PK ! �%�, �, script_helper.pynu �[��� # Common utility functions used by various script execution tests # e.g. test_cmd_line, test_cmd_line_script and test_runpy import collections import importlib import sys import os import os.path import subprocess import py_compile import zipfile from importlib.util import source_from_cache from test import support from test.support.import_helper import make_legacy_pyc # Cached result of the expensive test performed in the function below. __cached_interp_requires_environment = None def interpreter_requires_environment(): """ Returns True if our sys.executable interpreter requires environment variables in order to be able to run at all. This is designed to be used with @unittest.skipIf() to annotate tests that need to use an assert_python*() function to launch an isolated mode (-I) or no environment mode (-E) sub-interpreter process. A normal build & test does not run into this situation but it can happen when trying to run the standard library test suite from an interpreter that doesn't have an obvious home with Python's current home finding logic. Setting PYTHONHOME is one way to get most of the testsuite to run in that situation. PYTHONPATH or PYTHONUSERSITE are other common environment variables that might impact whether or not the interpreter can start. """ global __cached_interp_requires_environment if __cached_interp_requires_environment is None: # If PYTHONHOME is set, assume that we need it if 'PYTHONHOME' in os.environ: __cached_interp_requires_environment = True return True # Try running an interpreter with -E to see if it works or not. try: subprocess.check_call([sys.executable, '-E', '-c', 'import sys; sys.exit(0)']) except subprocess.CalledProcessError: __cached_interp_requires_environment = True else: __cached_interp_requires_environment = False return __cached_interp_requires_environment class _PythonRunResult(collections.namedtuple("_PythonRunResult", ("rc", "out", "err"))): """Helper for reporting Python subprocess run results""" def fail(self, cmd_line): """Provide helpful details about failed subcommand runs""" # Limit to 80 lines to ASCII characters maxlen = 80 * 100 out, err = self.out, self.err if len(out) > maxlen: out = b'(... truncated stdout ...)' + out[-maxlen:] if len(err) > maxlen: err = b'(... truncated stderr ...)' + err[-maxlen:] out = out.decode('ascii', 'replace').rstrip() err = err.decode('ascii', 'replace').rstrip() raise AssertionError("Process return code is %d\n" "command line: %r\n" "\n" "stdout:\n" "---\n" "%s\n" "---\n" "\n" "stderr:\n" "---\n" "%s\n" "---" % (self.rc, cmd_line, out, err)) # Executing the interpreter in a subprocess def run_python_until_end(*args, **env_vars): env_required = interpreter_requires_environment() cwd = env_vars.pop('__cwd', None) if '__isolated' in env_vars: isolated = env_vars.pop('__isolated') else: isolated = not env_vars and not env_required cmd_line = [sys.executable, '-X', 'faulthandler'] if isolated: # isolated mode: ignore Python environment variables, ignore user # site-packages, and don't add the current directory to sys.path cmd_line.append('-I') elif not env_vars and not env_required: # ignore Python environment variables cmd_line.append('-E') # But a special flag that can be set to override -- in this case, the # caller is responsible to pass the full environment. if env_vars.pop('__cleanenv', None): env = {} if sys.platform == 'win32': # Windows requires at least the SYSTEMROOT environment variable to # start Python. env['SYSTEMROOT'] = os.environ['SYSTEMROOT'] # Other interesting environment variables, not copied currently: # COMSPEC, HOME, PATH, TEMP, TMPDIR, TMP. else: # Need to preserve the original environment, for in-place testing of # shared library builds. env = os.environ.copy() # set TERM='' unless the TERM environment variable is passed explicitly # see issues #11390 and #18300 if 'TERM' not in env_vars: env['TERM'] = '' env.update(env_vars) cmd_line.extend(args) proc = subprocess.Popen(cmd_line, stdin=subprocess.PIPE, stdout=subprocess.PIPE, stderr=subprocess.PIPE, env=env, cwd=cwd) with proc: try: out, err = proc.communicate() finally: proc.kill() subprocess._cleanup() rc = proc.returncode return _PythonRunResult(rc, out, err), cmd_line def _assert_python(expected_success, /, *args, **env_vars): res, cmd_line = run_python_until_end(*args, **env_vars) if (res.rc and expected_success) or (not res.rc and not expected_success): res.fail(cmd_line) return res def assert_python_ok(*args, **env_vars): """ Assert that running the interpreter with `args` and optional environment variables `env_vars` succeeds (rc == 0) and return a (return code, stdout, stderr) tuple. If the __cleanenv keyword is set, env_vars is used as a fresh environment. Python is started in isolated mode (command line option -I), except if the __isolated keyword is set to False. """ return _assert_python(True, *args, **env_vars) def assert_python_failure(*args, **env_vars): """ Assert that running the interpreter with `args` and optional environment variables `env_vars` fails (rc != 0) and return a (return code, stdout, stderr) tuple. See assert_python_ok() for more options. """ return _assert_python(False, *args, **env_vars) def spawn_python(*args, stdout=subprocess.PIPE, stderr=subprocess.STDOUT, **kw): """Run a Python subprocess with the given arguments. kw is extra keyword args to pass to subprocess.Popen. Returns a Popen object. """ cmd_line = [sys.executable] if not interpreter_requires_environment(): cmd_line.append('-E') cmd_line.extend(args) # Under Fedora (?), GNU readline can output junk on stderr when initialized, # depending on the TERM setting. Setting TERM=vt100 is supposed to disable # that. References: # - http://reinout.vanrees.org/weblog/2009/08/14/readline-invisible-character-hack.html # - http://stackoverflow.com/questions/15760712/python-readline-module-prints-escape-character-during-import # - http://lists.gnu.org/archive/html/bug-readline/2007-08/msg00004.html env = kw.setdefault('env', dict(os.environ)) env['TERM'] = 'vt100' return subprocess.Popen(cmd_line, stdin=subprocess.PIPE, stdout=stdout, stderr=stderr, **kw) def kill_python(p): """Run the given Popen process until completion and return stdout.""" p.stdin.close() data = p.stdout.read() p.stdout.close() # try to cleanup the child so we don't appear to leak when running # with regrtest -R. p.wait() subprocess._cleanup() return data def make_script(script_dir, script_basename, source, omit_suffix=False): script_filename = script_basename if not omit_suffix: script_filename += os.extsep + 'py' script_name = os.path.join(script_dir, script_filename) # The script should be encoded to UTF-8, the default string encoding with open(script_name, 'w', encoding='utf-8') as script_file: script_file.write(source) importlib.invalidate_caches() return script_name def make_zip_script(zip_dir, zip_basename, script_name, name_in_zip=None): zip_filename = zip_basename+os.extsep+'zip' zip_name = os.path.join(zip_dir, zip_filename) with zipfile.ZipFile(zip_name, 'w') as zip_file: if name_in_zip is None: parts = script_name.split(os.sep) if len(parts) >= 2 and parts[-2] == '__pycache__': legacy_pyc = make_legacy_pyc(source_from_cache(script_name)) name_in_zip = os.path.basename(legacy_pyc) script_name = legacy_pyc else: name_in_zip = os.path.basename(script_name) zip_file.write(script_name, name_in_zip) #if test.support.verbose: # with zipfile.ZipFile(zip_name, 'r') as zip_file: # print 'Contents of %r:' % zip_name # zip_file.printdir() return zip_name, os.path.join(zip_name, name_in_zip) def make_pkg(pkg_dir, init_source=''): os.mkdir(pkg_dir) make_script(pkg_dir, '__init__', init_source) def make_zip_pkg(zip_dir, zip_basename, pkg_name, script_basename, source, depth=1, compiled=False): unlink = [] init_name = make_script(zip_dir, '__init__', '') unlink.append(init_name) init_basename = os.path.basename(init_name) script_name = make_script(zip_dir, script_basename, source) unlink.append(script_name) if compiled: init_name = py_compile.compile(init_name, doraise=True) script_name = py_compile.compile(script_name, doraise=True) unlink.extend((init_name, script_name)) pkg_names = [os.sep.join([pkg_name]*i) for i in range(1, depth+1)] script_name_in_zip = os.path.join(pkg_names[-1], os.path.basename(script_name)) zip_filename = zip_basename+os.extsep+'zip' zip_name = os.path.join(zip_dir, zip_filename) with zipfile.ZipFile(zip_name, 'w') as zip_file: for name in pkg_names: init_name_in_zip = os.path.join(name, init_basename) zip_file.write(init_name, init_name_in_zip) zip_file.write(script_name, script_name_in_zip) for name in unlink: os.unlink(name) #if test.support.verbose: # with zipfile.ZipFile(zip_name, 'r') as zip_file: # print 'Contents of %r:' % zip_name # zip_file.printdir() return zip_name, os.path.join(zip_name, script_name_in_zip) def run_test_script(script): # use -u to try to get the full output if the test hangs or crash if support.verbose: def title(text): return f"===== {text} ======" name = f"script {os.path.basename(script)}" print() print(title(name), flush=True) # In verbose mode, the child process inherit stdout and stdout, # to see output in realtime and reduce the risk of losing output. args = [sys.executable, "-E", "-X", "faulthandler", "-u", script, "-v"] proc = subprocess.run(args) print(title(f"{name} completed: exit code {proc.returncode}"), flush=True) if proc.returncode: raise AssertionError(f"{name} failed") else: assert_python_ok("-u", script, "-v") PK ! e�N�8 8 import_helper.pynu �[��� import contextlib import importlib import importlib.util import os import shutil import sys import unittest import warnings from .os_helper import unlink @contextlib.contextmanager def _ignore_deprecated_imports(ignore=True): """Context manager to suppress package and module deprecation warnings when importing them. If ignore is False, this context manager has no effect. """ if ignore: with warnings.catch_warnings(): warnings.filterwarnings("ignore", ".+ (module|package)", DeprecationWarning) yield else: yield def unload(name): try: del sys.modules[name] except KeyError: pass def forget(modname): """'Forget' a module was ever imported. This removes the module from sys.modules and deletes any PEP 3147/488 or legacy .pyc files. """ unload(modname) for dirname in sys.path: source = os.path.join(dirname, modname + '.py') # It doesn't matter if they exist or not, unlink all possible # combinations of PEP 3147/488 and legacy pyc files. unlink(source + 'c') for opt in ('', 1, 2): unlink(importlib.util.cache_from_source(source, optimization=opt)) def make_legacy_pyc(source): """Move a PEP 3147/488 pyc file to its legacy pyc location. :param source: The file system path to the source file. The source file does not need to exist, however the PEP 3147/488 pyc file must exist. :return: The file system path to the legacy pyc file. """ pyc_file = importlib.util.cache_from_source(source) up_one = os.path.dirname(os.path.abspath(source)) legacy_pyc = os.path.join(up_one, source + 'c') shutil.move(pyc_file, legacy_pyc) return legacy_pyc def import_module(name, deprecated=False, *, required_on=()): """Import and return the module to be tested, raising SkipTest if it is not available. If deprecated is True, any module or package deprecation messages will be suppressed. If a module is required on a platform but optional for others, set required_on to an iterable of platform prefixes which will be compared against sys.platform. """ with _ignore_deprecated_imports(deprecated): try: return importlib.import_module(name) except ImportError as msg: if sys.platform.startswith(tuple(required_on)): raise raise unittest.SkipTest(str(msg)) def _save_and_remove_modules(names): orig_modules = {} prefixes = tuple(name + '.' for name in names) for modname in list(sys.modules): if modname in names or modname.startswith(prefixes): orig_modules[modname] = sys.modules.pop(modname) return orig_modules def import_fresh_module(name, fresh=(), blocked=(), deprecated=False): """Import and return a module, deliberately bypassing sys.modules. This function imports and returns a fresh copy of the named Python module by removing the named module from sys.modules before doing the import. Note that unlike reload, the original module is not affected by this operation. *fresh* is an iterable of additional module names that are also removed from the sys.modules cache before doing the import. If one of these modules can't be imported, None is returned. *blocked* is an iterable of module names that are replaced with None in the module cache during the import to ensure that attempts to import them raise ImportError. The named module and any modules named in the *fresh* and *blocked* parameters are saved before starting the import and then reinserted into sys.modules when the fresh import is complete. Module and package deprecation messages are suppressed during this import if *deprecated* is True. This function will raise ImportError if the named module cannot be imported. """ # NOTE: test_heapq, test_json and test_warnings include extra sanity checks # to make sure that this utility function is working as expected with _ignore_deprecated_imports(deprecated): # Keep track of modules saved for later restoration as well # as those which just need a blocking entry removed fresh = list(fresh) blocked = list(blocked) names = {name, *fresh, *blocked} orig_modules = _save_and_remove_modules(names) for modname in blocked: sys.modules[modname] = None try: # Return None when one of the "fresh" modules can not be imported. try: for modname in fresh: __import__(modname) except ImportError: return None return importlib.import_module(name) finally: _save_and_remove_modules(names) sys.modules.update(orig_modules) class CleanImport(object): """Context manager to force import to return a new module reference. This is useful for testing module-level behaviours, such as the emission of a DeprecationWarning on import. Use like this: with CleanImport("foo"): importlib.import_module("foo") # new reference """ def __init__(self, *module_names): self.original_modules = sys.modules.copy() for module_name in module_names: if module_name in sys.modules: module = sys.modules[module_name] # It is possible that module_name is just an alias for # another module (e.g. stub for modules renamed in 3.x). # In that case, we also need delete the real module to clear # the import cache. if module.__name__ != module_name: del sys.modules[module.__name__] del sys.modules[module_name] def __enter__(self): return self def __exit__(self, *ignore_exc): sys.modules.update(self.original_modules) class DirsOnSysPath(object): """Context manager to temporarily add directories to sys.path. This makes a copy of sys.path, appends any directories given as positional arguments, then reverts sys.path to the copied settings when the context ends. Note that *all* sys.path modifications in the body of the context manager, including replacement of the object, will be reverted at the end of the block. """ def __init__(self, *paths): self.original_value = sys.path[:] self.original_object = sys.path sys.path.extend(paths) def __enter__(self): return self def __exit__(self, *ignore_exc): sys.path = self.original_object sys.path[:] = self.original_value def modules_setup(): return sys.modules.copy(), def modules_cleanup(oldmodules): # Encoders/decoders are registered permanently within the internal # codec cache. If we destroy the corresponding modules their # globals will be set to None which will trip up the cached functions. encodings = [(k, v) for k, v in sys.modules.items() if k.startswith('encodings.')] sys.modules.clear() sys.modules.update(encodings) # XXX: This kind of problem can affect more than just encodings. # In particular extension modules (such as _ssl) don't cope # with reloading properly. Really, test modules should be cleaning # out the test specific modules they know they added (ala test_runpy) # rather than relying on this function (as test_importhooks and test_pkg # do currently). Implicitly imported *real* modules should be left alone # (see issue 10556). sys.modules.update(oldmodules) PK ! �^d��, �, socket_helper.pynu �[��� import contextlib import errno import socket import unittest import sys from .. import support HOST = "localhost" HOSTv4 = "127.0.0.1" HOSTv6 = "::1" def find_unused_port(family=socket.AF_INET, socktype=socket.SOCK_STREAM): """Returns an unused port that should be suitable for binding. This is achieved by creating a temporary socket with the same family and type as the 'sock' parameter (default is AF_INET, SOCK_STREAM), and binding it to the specified host address (defaults to 0.0.0.0) with the port set to 0, eliciting an unused ephemeral port from the OS. The temporary socket is then closed and deleted, and the ephemeral port is returned. Either this method or bind_port() should be used for any tests where a server socket needs to be bound to a particular port for the duration of the test. Which one to use depends on whether the calling code is creating a python socket, or if an unused port needs to be provided in a constructor or passed to an external program (i.e. the -accept argument to openssl's s_server mode). Always prefer bind_port() over find_unused_port() where possible. Hard coded ports should *NEVER* be used. As soon as a server socket is bound to a hard coded port, the ability to run multiple instances of the test simultaneously on the same host is compromised, which makes the test a ticking time bomb in a buildbot environment. On Unix buildbots, this may simply manifest as a failed test, which can be recovered from without intervention in most cases, but on Windows, the entire python process can completely and utterly wedge, requiring someone to log in to the buildbot and manually kill the affected process. (This is easy to reproduce on Windows, unfortunately, and can be traced to the SO_REUSEADDR socket option having different semantics on Windows versus Unix/Linux. On Unix, you can't have two AF_INET SOCK_STREAM sockets bind, listen and then accept connections on identical host/ports. An EADDRINUSE OSError will be raised at some point (depending on the platform and the order bind and listen were called on each socket). However, on Windows, if SO_REUSEADDR is set on the sockets, no EADDRINUSE will ever be raised when attempting to bind two identical host/ports. When accept() is called on each socket, the second caller's process will steal the port from the first caller, leaving them both in an awkwardly wedged state where they'll no longer respond to any signals or graceful kills, and must be forcibly killed via OpenProcess()/TerminateProcess(). The solution on Windows is to use the SO_EXCLUSIVEADDRUSE socket option instead of SO_REUSEADDR, which effectively affords the same semantics as SO_REUSEADDR on Unix. Given the propensity of Unix developers in the Open Source world compared to Windows ones, this is a common mistake. A quick look over OpenSSL's 0.9.8g source shows that they use SO_REUSEADDR when openssl.exe is called with the 's_server' option, for example. See http://bugs.python.org/issue2550 for more info. The following site also has a very thorough description about the implications of both REUSEADDR and EXCLUSIVEADDRUSE on Windows: https://learn.microsoft.com/windows/win32/winsock/using-so-reuseaddr-and-so-exclusiveaddruse XXX: although this approach is a vast improvement on previous attempts to elicit unused ports, it rests heavily on the assumption that the ephemeral port returned to us by the OS won't immediately be dished back out to some other process when we close and delete our temporary socket but before our calling code has a chance to bind the returned port. We can deal with this issue if/when we come across it. """ with socket.socket(family, socktype) as tempsock: port = bind_port(tempsock) del tempsock return port def bind_port(sock, host=HOST): """Bind the socket to a free port and return the port number. Relies on ephemeral ports in order to ensure we are using an unbound port. This is important as many tests may be running simultaneously, especially in a buildbot environment. This method raises an exception if the sock.family is AF_INET and sock.type is SOCK_STREAM, *and* the socket has SO_REUSEADDR or SO_REUSEPORT set on it. Tests should *never* set these socket options for TCP/IP sockets. The only case for setting these options is testing multicasting via multiple UDP sockets. Additionally, if the SO_EXCLUSIVEADDRUSE socket option is available (i.e. on Windows), it will be set on the socket. This will prevent anyone else from bind()'ing to our host/port for the duration of the test. """ if sock.family == socket.AF_INET and sock.type == socket.SOCK_STREAM: if hasattr(socket, 'SO_REUSEADDR'): if sock.getsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR) == 1: raise support.TestFailed("tests should never set the " "SO_REUSEADDR socket option on " "TCP/IP sockets!") if hasattr(socket, 'SO_REUSEPORT'): try: if sock.getsockopt(socket.SOL_SOCKET, socket.SO_REUSEPORT) == 1: raise support.TestFailed("tests should never set the " "SO_REUSEPORT socket option on " "TCP/IP sockets!") except OSError: # Python's socket module was compiled using modern headers # thus defining SO_REUSEPORT but this process is running # under an older kernel that does not support SO_REUSEPORT. pass if hasattr(socket, 'SO_EXCLUSIVEADDRUSE'): sock.setsockopt(socket.SOL_SOCKET, socket.SO_EXCLUSIVEADDRUSE, 1) sock.bind((host, 0)) port = sock.getsockname()[1] return port def bind_unix_socket(sock, addr): """Bind a unix socket, raising SkipTest if PermissionError is raised.""" assert sock.family == socket.AF_UNIX try: sock.bind(addr) except PermissionError: sock.close() raise unittest.SkipTest('cannot bind AF_UNIX sockets') def _is_ipv6_enabled(): """Check whether IPv6 is enabled on this host.""" if socket.has_ipv6: sock = None try: sock = socket.socket(socket.AF_INET6, socket.SOCK_STREAM) sock.bind((HOSTv6, 0)) return True except OSError: pass finally: if sock: sock.close() return False IPV6_ENABLED = _is_ipv6_enabled() _bind_nix_socket_error = None def skip_unless_bind_unix_socket(test): """Decorator for tests requiring a functional bind() for unix sockets.""" if not hasattr(socket, 'AF_UNIX'): return unittest.skip('No UNIX Sockets')(test) global _bind_nix_socket_error if _bind_nix_socket_error is None: from .os_helper import TESTFN, unlink path = TESTFN + "can_bind_unix_socket" with socket.socket(socket.AF_UNIX) as sock: try: sock.bind(path) _bind_nix_socket_error = False except OSError as e: _bind_nix_socket_error = e finally: unlink(path) if _bind_nix_socket_error: msg = 'Requires a functional unix bind(): %s' % _bind_nix_socket_error return unittest.skip(msg)(test) else: return test def get_socket_conn_refused_errs(): """ Get the different socket error numbers ('errno') which can be received when a connection is refused. """ errors = [errno.ECONNREFUSED] if hasattr(errno, 'ENETUNREACH'): # On Solaris, ENETUNREACH is returned sometimes instead of ECONNREFUSED errors.append(errno.ENETUNREACH) if hasattr(errno, 'EADDRNOTAVAIL'): # bpo-31910: socket.create_connection() fails randomly # with EADDRNOTAVAIL on Travis CI errors.append(errno.EADDRNOTAVAIL) if hasattr(errno, 'EHOSTUNREACH'): # bpo-37583: The destination host cannot be reached errors.append(errno.EHOSTUNREACH) if not IPV6_ENABLED: errors.append(errno.EAFNOSUPPORT) return errors _NOT_SET = object() @contextlib.contextmanager def transient_internet(resource_name, *, timeout=_NOT_SET, errnos=()): """Return a context manager that raises ResourceDenied when various issues with the internet connection manifest themselves as exceptions.""" import nntplib import urllib.error if timeout is _NOT_SET: timeout = support.INTERNET_TIMEOUT default_errnos = [ ('ECONNREFUSED', 111), ('ECONNRESET', 104), ('EHOSTUNREACH', 113), ('ENETUNREACH', 101), ('ETIMEDOUT', 110), # socket.create_connection() fails randomly with # EADDRNOTAVAIL on Travis CI. ('EADDRNOTAVAIL', 99), ] default_gai_errnos = [ ('EAI_AGAIN', -3), ('EAI_FAIL', -4), ('EAI_NONAME', -2), ('EAI_NODATA', -5), # Encountered when trying to resolve IPv6-only hostnames ('WSANO_DATA', 11004), ] denied = support.ResourceDenied("Resource %r is not available" % resource_name) captured_errnos = errnos gai_errnos = [] if not captured_errnos: captured_errnos = [getattr(errno, name, num) for (name, num) in default_errnos] gai_errnos = [getattr(socket, name, num) for (name, num) in default_gai_errnos] def filter_error(err): n = getattr(err, 'errno', None) if (isinstance(err, TimeoutError) or (isinstance(err, socket.gaierror) and n in gai_errnos) or (isinstance(err, urllib.error.HTTPError) and 500 <= err.code <= 599) or (isinstance(err, urllib.error.URLError) and (("ConnectionRefusedError" in err.reason) or ("TimeoutError" in err.reason) or ("EOFError" in err.reason))) or n in captured_errnos): if not support.verbose: sys.stderr.write(denied.args[0] + "\n") raise denied from err old_timeout = socket.getdefaulttimeout() try: if timeout is not None: socket.setdefaulttimeout(timeout) yield except nntplib.NNTPTemporaryError as err: if support.verbose: sys.stderr.write(denied.args[0] + "\n") raise denied from err except OSError as err: # urllib can wrap original socket errors multiple times (!), we must # unwrap to get at the original error. while True: a = err.args if len(a) >= 1 and isinstance(a[0], OSError): err = a[0] # The error can also be wrapped as args[1]: # except socket.error as msg: # raise OSError('socket error', msg).with_traceback(sys.exc_info()[2]) elif len(a) >= 2 and isinstance(a[1], OSError): err = a[1] else: break filter_error(err) raise # XXX should we catch generic exceptions and look for their # __cause__ or __context__? finally: socket.setdefaulttimeout(old_timeout) PK ! ��Ü% �% ) __pycache__/socket_helper.cpython-310.pycnu �[��� o p̦i�, � @ s� d dl Z d dlZd dlZd dlZd dlZddlmZ dZdZdZ ej ej fdd�Z efd d �Z d d � Zd d� Ze� Zdadd� Zdd� Ze� Ze jedd�dd��ZdS )� N� )�support� localhostz 127.0.0.1z::1c C s> t � | |��}t|�}W d � ~|S 1 sw Y ~|S )a Returns an unused port that should be suitable for binding. This is achieved by creating a temporary socket with the same family and type as the 'sock' parameter (default is AF_INET, SOCK_STREAM), and binding it to the specified host address (defaults to 0.0.0.0) with the port set to 0, eliciting an unused ephemeral port from the OS. The temporary socket is then closed and deleted, and the ephemeral port is returned. Either this method or bind_port() should be used for any tests where a server socket needs to be bound to a particular port for the duration of the test. Which one to use depends on whether the calling code is creating a python socket, or if an unused port needs to be provided in a constructor or passed to an external program (i.e. the -accept argument to openssl's s_server mode). Always prefer bind_port() over find_unused_port() where possible. Hard coded ports should *NEVER* be used. As soon as a server socket is bound to a hard coded port, the ability to run multiple instances of the test simultaneously on the same host is compromised, which makes the test a ticking time bomb in a buildbot environment. On Unix buildbots, this may simply manifest as a failed test, which can be recovered from without intervention in most cases, but on Windows, the entire python process can completely and utterly wedge, requiring someone to log in to the buildbot and manually kill the affected process. (This is easy to reproduce on Windows, unfortunately, and can be traced to the SO_REUSEADDR socket option having different semantics on Windows versus Unix/Linux. On Unix, you can't have two AF_INET SOCK_STREAM sockets bind, listen and then accept connections on identical host/ports. An EADDRINUSE OSError will be raised at some point (depending on the platform and the order bind and listen were called on each socket). However, on Windows, if SO_REUSEADDR is set on the sockets, no EADDRINUSE will ever be raised when attempting to bind two identical host/ports. When accept() is called on each socket, the second caller's process will steal the port from the first caller, leaving them both in an awkwardly wedged state where they'll no longer respond to any signals or graceful kills, and must be forcibly killed via OpenProcess()/TerminateProcess(). The solution on Windows is to use the SO_EXCLUSIVEADDRUSE socket option instead of SO_REUSEADDR, which effectively affords the same semantics as SO_REUSEADDR on Unix. Given the propensity of Unix developers in the Open Source world compared to Windows ones, this is a common mistake. A quick look over OpenSSL's 0.9.8g source shows that they use SO_REUSEADDR when openssl.exe is called with the 's_server' option, for example. See http://bugs.python.org/issue2550 for more info. The following site also has a very thorough description about the implications of both REUSEADDR and EXCLUSIVEADDRUSE on Windows: https://learn.microsoft.com/windows/win32/winsock/using-so-reuseaddr-and-so-exclusiveaddruse XXX: although this approach is a vast improvement on previous attempts to elicit unused ports, it rests heavily on the assumption that the ephemeral port returned to us by the OS won't immediately be dished back out to some other process when we close and delete our temporary socket but before our calling code has a chance to bind the returned port. We can deal with this issue if/when we come across it. N)�socket� bind_port)�family�socktype�tempsock�port� r �1/usr/lib/python3.10/test/support/socket_helper.py�find_unused_port s 8 ��r c C s� | j tjkrN| jtjkrNttd�r | �tjtj�dkr t � d��ttd�r@z| �tjtj �dkr5t � d��W n t y? Y nw ttd�rN| � tjtjd� | �|df� | �� d }|S )a% Bind the socket to a free port and return the port number. Relies on ephemeral ports in order to ensure we are using an unbound port. This is important as many tests may be running simultaneously, especially in a buildbot environment. This method raises an exception if the sock.family is AF_INET and sock.type is SOCK_STREAM, *and* the socket has SO_REUSEADDR or SO_REUSEPORT set on it. Tests should *never* set these socket options for TCP/IP sockets. The only case for setting these options is testing multicasting via multiple UDP sockets. Additionally, if the SO_EXCLUSIVEADDRUSE socket option is available (i.e. on Windows), it will be set on the socket. This will prevent anyone else from bind()'ing to our host/port for the duration of the test. � SO_REUSEADDR� zHtests should never set the SO_REUSEADDR socket option on TCP/IP sockets!� SO_REUSEPORTzHtests should never set the SO_REUSEPORT socket option on TCP/IP sockets!�SO_EXCLUSIVEADDRUSEr )r r �AF_INET�type� SOCK_STREAM�hasattr� getsockopt� SOL_SOCKETr r � TestFailedr �OSError� setsockoptr �bind� getsockname)�sock�hostr r r r r L s" � � r c C sB | j tjksJ �z| �|� W dS ty | �� t�d��w )zBBind a unix socket, raising SkipTest if PermissionError is raised.zcannot bind AF_UNIX socketsN)r r �AF_UNIXr �PermissionError�close�unittest�SkipTest)r �addrr r r �bind_unix_sockets s �r% c C s| t jr<d} z.zt � t jt j�} | �tdf� W W | r | �� dS dS ty* Y nw W | r2| �� dS | r;| �� w w dS )z+Check whether IPv6 is enabled on this host.Nr TF)r �has_ipv6�AF_INET6r r �HOSTv6r! r )r r r r �_is_ipv6_enabled| s( � ��� �r) c C s� t td�s t�d�| �S tdu r\ddlm}m} |d }t�tj��2}z$z |� |� daW n t yA } z|aW Y d}~nd}~ww W ||� n||� w W d � n1 sWw Y tridt }t�|�| �S | S ) zCDecorator for tests requiring a functional bind() for unix sockets.r zNo UNIX SocketsNr )�TESTFN�unlink�can_bind_unix_socketFz%Requires a functional unix bind(): %s) r r r" �skip�_bind_nix_socket_error� os_helperr* r+ r r r )�testr* r+ �pathr �e�msgr r r � skip_unless_bind_unix_socket� s( ��� �r4 c C s^ t jg} tt d�r| �t j� tt d�r| �t j� tt d�r%| �t j� ts-| �t j� | S )zr Get the different socket error numbers ('errno') which can be received when a connection is refused. � ENETUNREACH� EADDRNOTAVAIL� EHOSTUNREACH) �errno� ECONNREFUSEDr �appendr5 r6 r7 � IPV6_ENABLED� EAFNOSUPPORT)�errorsr r r � get_socket_conn_refused_errs� s r> r )�timeout�errnosc # sl � ddl }ddl�|tu rtj}g d�}g d�}t�d| ��|� g �� s3dd� |D �� dd� |D ��� ���fd d �}t�� }zoz|durKt�|� dV W nX |j ym } ztj rft j � �jd d � �|�d}~w ty� } z/ |j} t| �d kr�t| d t�r�| d }nt| �dkr�t| d t�r�| d }nnqu||� � d}~ww W t�|� dS t�|� w )z�Return a context manager that raises ResourceDenied when various issues with the internet connection manifest themselves as exceptions.r N))r9 �o )� ECONNRESET�h )r7 �q )r5 �e )� ETIMEDOUT�n )r6 �c ))� EAI_AGAIN���)�EAI_FAIL���)� EAI_NONAME���)� EAI_NODATA���)� WSANO_DATAi�* z Resource %r is not availablec S � g | ] \}}t t||��qS r )�getattrr8 ��.0�name�numr r r � <listcomp>� � �z&transient_internet.<locals>.<listcomp>c S rR r )rS r rT r r r rX � rY c s� t | dd �}t| t�sBt| tj�r|�v sBt| �jj�r(d| j kr'dksBn t| �jj�r>d| j v sBd| j v sBd| j v sB|� v rSt j sPt j ��jd d � �| �d S ) Nr8 i� iW �ConnectionRefusedError� TimeoutError�EOFErrorr � )rS � isinstancer[ r �gaierror�error� HTTPError�code�URLError�reasonr �verbose�sys�stderr�write�args)�err�n��captured_errnos�denied� gai_errnos�urllibr r � filter_error� s$ � � � �z(transient_internet.<locals>.filter_errorr] Tr r )�nntplib� urllib.error�_NOT_SETr �INTERNET_TIMEOUT�ResourceDeniedr �getdefaulttimeout�setdefaulttimeout�NNTPTemporaryErrorre rf rg rh ri r �lenr^ ) � resource_namer? r@ rr �default_errnos�default_gai_errnosrq � old_timeoutrj �ar rl r �transient_internet� sV � �� � � ���r� )� contextlibr8 r r" rf � r �HOST�HOSTv4r( r r r r r% r) r; r. r4 r> �objectrt �contextmanagerr� r r r r �<module> s( =' PK ! ~�YJ7 J7 % __pycache__/os_helper.cpython-310.pycnu �[��� o p̦i�M � @ s d dl Zd dlZd dlZd dlZd dlZd dlZd dlZd dlZd dl Z d dl Z ej dkr0dZ ndZ d� e e�� �Z e d ZejdkrMd dlZe�de�ZdZej d kre�� jd kr~e d Zz e�e�� � W n eyq Y n1w ed ee�� f � dZn#ejdkr�z d �e�� � W n ey� e d�e�� d� ZY nw dZdD ] Z ze� e� e ��e kr�e �W n e y� Y q�w e Z e� � Z!dZ"dD ] Z z e �e�� � W q� ey� e� e �e Z"Y nw er�e e Z#ndZ#e#p�e Z$dd� Z%da&dd� Z'dd� Z(da)dd� Z*dd � Z+d d � Z,ej�-d ��r.dGd!d"�Z.d#d$� Z/d%d&� Z0d'd(� Z1d)d*� Z2nej,Z/ej3Z0d+d(� Z1d,d*� Z2d-d.� Z3d/d0� Z4ej5dHd1d2��Z6ej5dGd3d4��Z7ej5dId6d7��Z8d8d9� Z9ej5d:d;� �Z:d<d=� Z;G d>d?� d?�Z<d@dA� Z=e>edB��r�ej5dCdD� �Z?G dEdF� dFej@jA�ZBdS )J� N�javaz$testz@testz {}_{}_tmpu -àòɘŁğ�darwin�NFD�nt� u -共Ł♡ͣ�ztWARNING: The filename %r CAN be encoded by the filesystem encoding (%s). Unicode filename tests may not be effective� �s -��surrogateescape� ) � æu İu Łu φu Кu אu ،u تu ก� u €)s �w�r s ���s �s ��c C s8 t td�} z | �� W | �� tt� S | �� tt� w )z` Create an invalid file descriptor by opening and closing a file and return its fd. �wb)�open�TESTFN�fileno�close�unlink��file� r �-/usr/lib/python3.10/test/support/os_helper.py� make_bad_fd� s � r c C s^ t d urt S td } z t�t| � d}W n tttfy% d}Y |a |S w t�| � |a |S )N� can_symlinkTF)� _can_symlinkr �os�symlink�OSError�NotImplementedError�AttributeError�remove)� symlink_path�canr r r r � s � r c C � t � }d}|r | S t�|�| �S )z8Skip decorator for tests that require functional symlinkz*Requires functional symlink implementation)r �unittest�skip��test�ok�msgr r r �skip_unless_symlink� � r( c C sL dd l } td ur tS ttd�sd}|a|S dd l}| �� }| j|d�\}}zsttd��D}z0t� |dd� t� |dd � t� |� � dd� |� � }t � d |�}|d u pZt|�d ��d k}W n tyg d}Y nw W d � n1 srw Y W tt� t|� t|� |a|S W tt� t|� t|� |a|S tt� t|� t|� w ) Nr �setxattrF��dirr s user.test� s trusted.foos 42z 2.6.(\d{1,2})� �' )�tempfile� _can_xattr�hasattrr �platform�mkdtemp�mkstempr r r* r �release�re�match�int�groupr r �rmdir) r0 r r3 �tmp_dir�tmp_fp�tmp_name�fp�kernel_version�mr r r � can_xattr� sL � �� ��� rB c C r! )zDSkip decorator for tests that require functional extended attributesz(no non-broken extended attribute support)rB r" r# r$ r r r �skip_unless_xattr� r) rC c C s( zt | � W d S ttfy Y d S w �N)�_unlink�FileNotFoundError�NotADirectoryError��filenamer r r r � s �r �winFc C s� | |� |r |}n t j�|�\}}|pd}d}|dk r9t �|�}|r&|s,d S ||v s,d S t�|� |d9 }|dk stjd| tdd� d S )N�.g����MbP?g �?r z)tests may fail, delete still pending for � �� stacklevel) r �path�split�listdir�time�sleep�warnings�warn�RuntimeWarning)�func�pathname�waitall�dirname�name�timeout�Lr r r �_waitfor� s$ � � �r^ c C � t tj| � d S rD )r^ r r rH r r r rE � rE c C r_ rD )r^ r r; �rZ r r r �_rmdir r` rb c s> ddl m� � �fdd��t�| dd� t� fdd�| � d S ) Nr �� _force_runc s� � | t j| �D ]L}t j�| |�}zt �|�j}W n ty7 } ztd||f tj d� d}W Y d }~nd }~ww t � |�rLt �|dd� � |t j |� q� |t j|� qd S )Nz-support.rmtree(): os.lstat(%r) failed with %sr r T�rY )r rQ rO �join�lstat�st_moder �print�sys� __stderr__�stat�S_ISDIRr^ r; r )rO r[ �fullname�mode�exc�rd � _rmtree_innerr r rr s$ ���� � _rmtree.<locals>._rmtree_innerTre c s � | t j| �S rD )r r; )�prc r r �<lambda>. s z_rmtree.<locals>.<lambda>)� test.supportrd r^ �rO r rq r �_rmtree s rx c C s^ zdd l }W n ty Y | S w |�t| �d �}|jj�| |t|��}|r-|d |� S | S )Nr r )�ctypes� ImportError�create_unicode_buffer�len�windll�kernel32�GetLongPathNameW)rO ry �buffer�lengthr r r � _longpath0 s � � r� c sN dd l }z|�| � W d S ty Y nw � fdd�� � | � t�| � d S )Nr c s� ddl m} || tj| �D ]5}tj�| |�}zt�|�j}W n ty) d}Y nw t � |�r;� |� || tj |� q || tj |� q d S )Nr rc ) rv rd r rQ rO rf rg rh r rl rm r; r )rO rd r[ rn ro �rr r r rr I s � �rs )�shutil�rmtreer r r; )rO r� r r� r rx A s � c C � | S rD r rw r r r r� Y � c C �$ zt | � W d S ty Y d S w rD )rb rF ra r r r r; ] � �r; c C r� rD )rx rF rw r r r r� d r� r� c c s� � ddl }d}| du r|�� } d}tj�| �} n-z t�| � d}W n# tyD } z|s,� tjd| �d|� �t dd� W Y d}~nd}~ww |rKt� � }z| V W |r^|t� � kr`t | � dS dS dS |ro|t� � krpt | � w w w ) a� Return a context manager that creates a temporary directory. Arguments: path: the directory to create temporarily. If omitted or None, defaults to creating a temporary directory using tempfile.mkdtemp. quiet: if False (the default), the context manager raises an exception on error. Otherwise, if the path is specified and cannot be created, only a warning is issued. r NFTz5tests may fail, unable to create temporary directory �: � rM ) r0 r4 r rO �realpath�mkdirr rT rU rV �getpidr� )rO �quietr0 � dir_createdrp �pidr r r �temp_dirk s> � ����� � �r� c c s� � t �� }z t �t j�| �� W n# ty3 } z|s� tjd| �d|� �tdd� W Y d}~nd}~ww z t �� V W t �|� dS t �|� w )ag Return a context manager that changes the current working directory. Arguments: path: the directory to use as the temporary current working directory. quiet: if False (the default), the context manager raises an exception on error. Otherwise, it issues only a warning and keeps the current working directory the same. zBtests may fail, unable to change the current working directory to r� r� rM N) r �getcwd�chdirrO r� r rT rU rV )rO r� � saved_dirrp r r r � change_cwd� s& � ����� r� �tempcwdc c sv � t | |d��*}t||d�� }|V W d � n1 s w Y W d � dS W d � dS 1 s4w Y dS )a� Context manager that temporarily creates and changes the CWD. The function temporarily changes the current working directory after creating a temporary directory in the current directory with name *name*. If *name* is None, the temporary directory is created using tempfile.mkdtemp. If *quiet* is False (default) and it is not possible to create or change the CWD, an error is raised. If *quiet* is True, only a warning is raised and the original CWD is used. )rO r� )r� N)r� r� )r[ r� � temp_path�cwd_dirr r r �temp_cwd� s � ��"�r� c C s( t �| t jt jB t jB �}t �|� dS )z>Create an empty file. If the file already exists, truncate it.N)r r �O_WRONLY�O_CREAT�O_TRUNCr )rI �fdr r r �create_empty_file� s r� c c sD � t j�| �s J �t �| t j�}z |V W t �|� dS t �|� w )z&Open a file descriptor to a directory.N)r rO �isdirr �O_RDONLYr )rO �dir_fdr r r � open_dir_fd� s �r� c C s� ddl }|j| d��0}|j}|�� }||kr|�� }ztj�||�W W d � S ty9 Y W d � dS w 1 s=w Y dS )zODetects if the file system for the specified directory is case-insensitive.r Nr+ F) r0 �NamedTemporaryFiler[ �upper�lowerr rO �samefilerF )� directoryr0 �base� base_path� case_pathr r r �fs_is_case_insensitive� s � ��r� c @ s( e Zd ZdZdd� Zdd� Zdd� ZdS ) �FakePathz.Simple implementing of the path protocol. c C s || _ d S rD rw )�selfrO r r r �__init__� � zFakePath.__init__c C s d| j �d�S )Nz <FakePath �>rw �r� r r r �__repr__� s zFakePath.__repr__c C s0 t | jt�st | jt�rt| jt�r| j�| jS rD )� isinstancerO � BaseException�type� issubclassr� r r r � __fspath__� s � �zFakePath.__fspath__N)�__name__� __module__� __qualname__�__doc__r� r� r� r r r r r� � s r� c C s� t j�d�r z t�d�} t| �d W S ty Y nw d}ttd�r4zt�d�}W n t y3 Y nw d}t jdkrez d dl }|j W n t t fyO Y nw i }|j|j|jfD ] }|� |d �||< qZzMd }t|�D ],}zt�|�}W n t y� } z |jtjkr�� W Y d}~qld}~ww t�|� |d7 }qlW |dur�|j|j|jfD ] }|� ||| � q�|S |dur�|j|j|jfD ] }|� ||| � q�w w ) z/Count the number of open file descriptors. )�linux�freebsdz /proc/self/fdr. � �sysconf� SC_OPEN_MAXN�win32r )rj r3 � startswithr rQ r| rF r2 r� r �msvcrt�CrtSetReportModer rz �CRT_WARN� CRT_ERROR� CRT_ASSERT�range�dup�errno�EBADFr ) �names�MAXFD� old_modesr� � report_type�countr� �fd2�er r r �fd_count� sv � � �� � ��� � ����r� �umaskc c s0 � t �| �}z dV W t �|� dS t �|� w )z8Context manager that temporarily sets the process umask.N)r r� )r� �oldmaskr r r � temp_umask3 s � r� c @ sh e Zd ZdZdd� Zdd� Zdd� Zdd � Zd d � Zd d � Z dd� Z dd� Z dd� Z dd� Z dd� ZdS )�EnvironmentVarGuardz_Class to help protect the environment variable properly. Can be used as a context manager.c C s t j| _i | _d S rD )r �environ�_environ�_changedr� r r r r� B s z EnvironmentVarGuard.__init__c C s | j | S rD )r� �r� �envvarr r r � __getitem__F r� z EnvironmentVarGuard.__getitem__c C s* || j vr| j�|�| j |< || j|< d S rD �r� r� �get�r� r� �valuer r r � __setitem__I s z EnvironmentVarGuard.__setitem__c C s6 || j vr| j�|�| j |< || jv r| j|= d S d S rD r� r� r r r � __delitem__O s �z EnvironmentVarGuard.__delitem__c C s | j �� S rD )r� �keysr� r r r r� V r� zEnvironmentVarGuard.keysc C � t | j�S rD )�iterr� r� r r r �__iter__Y r� z EnvironmentVarGuard.__iter__c C r� rD )r| r� r� r r r �__len__\ r� zEnvironmentVarGuard.__len__c C s || |< d S rD r r� r r r �set_ s zEnvironmentVarGuard.setc C s | |= d S rD r r� r r r �unsetb r� zEnvironmentVarGuard.unsetc C r� rD r r� r r r � __enter__e r� z EnvironmentVarGuard.__enter__c G sF | j �� D ]\}}|d u r|| jv r| j|= q|| j|< q| jt_d S rD )r� �itemsr� r r� )r� � ignore_exc�k�vr r r �__exit__h s � z EnvironmentVarGuard.__exit__N)r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r r r r r� = s r� )F)NF)r� F)C�collections.abc� collections� contextlibr� r r7 rl rj rR r" rT r[ � TESTFN_ASCII�formatr� �TESTFN_UNICODEr3 � unicodedata� normalize�TESTFN_UNENCODABLE�getwindowsversion�encode�getfilesystemencoding�UnicodeEncodeErrorri �decode�UnicodeDecodeError� FS_NONASCII� character�fsdecode�fsencode� UnicodeErrorr� �SAVEDCWD�TESTFN_UNDECODABLE�TESTFN_NONASCIIr r r r r( r1 rB rC r r� r^ rE rb rx r� r; r� �contextmanagerr� r� r� r� r� r� r� r� r2 r� �abc�MutableMappingr� r r r r �<module> s� � �� ��!� � � ! ! ( < PK ! >Խ~ ~ & __pycache__/testresult.cpython-310.pycnu �[��� o p̦in � @ s2 d Z ddlZddlZddlZddlZddlZddlZG dd� dej�ZG dd� d�Z ddd �Z dd d �Z e d kr�ddl m mZ d e_G dd� dej�Ze�� Ze�e�e�� e�� Ze edd� ejD ���Z e ej �Z e � e�Z e!de�"� � e!ddd� e�#e �$� �D ] Z%e!e%�&� dd� q�e!� dS dS )z=Test runner and result class for the regression test suite. � Nc s� e Zd ZdZ� fdd�Zedd� �Z� fdd�Zddd �Zed d � �Z � fd d �Z � fdd�Z � fdd�Z � fdd�Z � fdd�Z� fdd�Zdd� Z� ZS )�RegressionTestResultFc sx t � j|||r dndd� d| _| jr7ddlm} ddlm} || _|�d�| _ | j � d|� � � d �� d | _ d | _d S ) N� r )�stream� descriptions� verbosityT)� ElementTree)�datetime� testsuite�start� )�super�__init__�buffer�USE_XML� xml.etreer r �_RegressionTestResult__ET�Element� _RegressionTestResult__suite�set�utcnow� isoformat�_RegressionTestResult__e�!_RegressionTestResult__start_time)�selfr r r �ETr �� __class__� �./usr/lib/python3.10/test/support/testresult.pyr s � z RegressionTestResult.__init__c C sJ z|j }W n ty t|� Y S w z|� W S ty$ t|� Y S w �N)�id�AttributeError�str� TypeError�repr)�cls�test�test_idr r r �__getId s � �z RegressionTestResult.__getIdc s6 t � �|� | jr| j�| jd� | _}t�� | _ d S )N�testcase) r � startTestr r � SubElementr r �time� perf_counterr )r r& �er r r r* ( s z RegressionTestResult.startTestc K sN | j sd S | j}d | _|d u rd S | j}|�d|�d| �|��� |�d|�dd�� |�d|�dd�� | jrE|�dt�� | j d�� |rm| j d urZ| j � � � � }||� |d�_ | jd urm| j� � � � }||� |d �_ |�� D ]3\}} |ry| szqq|� ||�} t| d �r�| �� D ]\} } | r�| �| t| �� q�t| �| _ q�qqt| �| _ qqd S ) N�name�status�run�result� completedr, z0.6fz system-outz system-err�items)r r r r �pop� _RegressionTestResult__getIdr r, r- �_stdout_buffer�getvalue�rstripr+ �text�_stderr_bufferr4 �hasattrr" ) r r& �capture�argsr. r �stdout�stderr�k�v�e2�k2�v2r r r � _add_result. s> � �z RegressionTestResult._add_resultc C sl t |t�r|jdkr|j}n|j� d|j� �}nt|�}t�||d �}t�|||�}|d�|�d�|�d�S )N�builtins�.� )�type�messagerI )� isinstancerJ � __module__�__name__r$ � traceback�format_exception�join)r% �err_type� err_value�err_tb�typename�msg�tbr r r �__makeErrorDictR s �z$RegressionTestResult.__makeErrorDictc �( | j |d| j|� d� t� �||� d S )NT)�error)rF �$_RegressionTestResult__makeErrorDictr �addError�r r& �errr r r r\ e � z RegressionTestResult.addErrorc rY )NT)�output)rF r[ r �addExpectedFailurer] r r r ra i r_ z'RegressionTestResult.addExpectedFailurec rY )NT)�failure)rF r[ r � addFailurer] r r r rc m r_ z RegressionTestResult.addFailurec s | j ||d� t� �||� d S )N)�skipped)rF r �addSkip)r r& �reasonr r r re q s z RegressionTestResult.addSkipc s | � |� t� �|� d S r )rF r � addSuccess�r r& r r r rg u s z RegressionTestResult.addSuccessc s | j |dd� t� �|� d S )N�UNEXPECTED_SUCCESS)�outcome)rF r �addUnexpectedSuccessrh r r r rk y s z)RegressionTestResult.addUnexpectedSuccessc C sV | j std��| j}|�dt| j�� |�dtt| j��� |�dtt| j��� |S )NzUSE_XML is false�tests�errors�failures) r � ValueErrorr r r" �testsRun�lenrm rn )r r. r r r �get_xml_element} s z$RegressionTestResult.get_xml_element�F)rN rM � __qualname__r r � classmethodr6 r* rF r[ r\ ra rc re rg rk rr � __classcell__r r r r r s $ r c @ s e Zd Zddd�Zdd� ZdS )�QuietRegressionTestRunnerFc C s t |d d�| _|| j_d S )Nr )r r2 r )r r r r r r r � s z"QuietRegressionTestRunner.__init__c C s || j � | j S r )r2 rh r r r r1 � s z QuietRegressionTestRunner.runNrs )rN rM rt r r1 r r r r rw � s rw Fc C s& | r t jtjt|| d�S t jt|d�S )N)� resultclassr r )r )� functools�partial�unittest�TextTestRunnerr rw )r r r r r �get_test_runner_class� s �r} c C s t ||�| �S r )r} )r r �capture_outputr r r �get_test_runner� � r �__main__Tc @ s, e Zd Zdd� Zdd� Zdd� Zdd� Zd S ) � TestTestsc C s d S r r �r r r r � test_pass� s zTestTests.test_passc C s t �d� d S )Ng �?)r, �sleepr� r r r �test_pass_slow� r� zTestTests.test_pass_slowc C s* t dtjd� t dtjd� | �d� d S )Nr? ��filer@ zfailure message)�print�sysr? r@ �failr� r r r � test_fail� s zTestTests.test_failc C s$ t dtjd� t dtjd� td��)Nr? r� r@ z error message)r� r� r? r@ � RuntimeErrorr� r r r � test_error� s zTestTests.test_errorN)rN rM rt r� r� r� r� r r r r r� � s r� c c s � | ]}|d kV qdS )z-vNr )�.0�ar r r � <genexpr>� s � r� zOutput:zXML: rI )�endrs )'�__doc__ry �ior� r, rO r{ �TextTestResultr rw r} r rN �xml.etree.ElementTree�etreer r r �TestCaser� � TestSuite�suite�addTest� makeSuite�StringIOr �sum�argv� runner_clsr? �runnerr1 r2 r� r8 � tostringlistrr �s�decoder r r r �<module> s6 z �PK ! Z�mȖ � ) __pycache__/import_helper.cpython-310.pycnu �[��� o p̦i8 � @ s� d dl Z d dlZd dlZd dlZd dlZd dlZd dlZd dlZddlm Z e j d dd��Z dd� Z d d � Z d d � Zd dd�dd�Zdd� Zd dd�ZG dd� de�ZG dd� de�Zdd� Zd d � ZdS )!� N� )�unlinkTc c sR � | r$t �� � t �ddt� dV W d � dS 1 s w Y dS dV dS )z�Context manager to suppress package and module deprecation warnings when importing them. If ignore is False, this context manager has no effect. �ignorez.+ (module|package)N)�warnings�catch_warnings�filterwarnings�DeprecationWarning)r � r �1/usr/lib/python3.10/test/support/import_helper.py�_ignore_deprecated_imports s � �"� r c C s$ zt j| = W d S ty Y d S w �N)�sys�modules�KeyError)�namer r r �unload s �r c C sT t | � tjD ] }tj�|| d �}t|d � dD ] }ttjj||d�� qqdS )z�'Forget' a module was ever imported. This removes the module from sys.modules and deletes any PEP 3147/488 or legacy .pyc files. z.py�c)� r � )� optimizationN) r r �path�os�joinr � importlib�util�cache_from_source)�modname�dirname�source�optr r r �forget$ s ��r c C sB t j�| �}tj�tj�| ��}tj�|| d �}t� ||� |S )a Move a PEP 3147/488 pyc file to its legacy pyc location. :param source: The file system path to the source file. The source file does not need to exist, however the PEP 3147/488 pyc file must exist. :return: The file system path to the legacy pyc file. r ) r r r r r r �abspathr �shutil�move)r �pyc_file�up_one� legacy_pycr r r �make_legacy_pyc4 s r' Fr )� required_onc C sr t |��+ z t�| �W W d � S ty. } ztj�t|��r#� t� t |���d}~ww 1 s2w Y dS )ac Import and return the module to be tested, raising SkipTest if it is not available. If deprecated is True, any module or package deprecation messages will be suppressed. If a module is required on a platform but optional for others, set required_on to an iterable of platform prefixes which will be compared against sys.platform. N) r r � import_module� ImportErrorr �platform� startswith�tuple�unittest�SkipTest�str)r � deprecatedr( �msgr r r r) B s ����r) c C sL i }t dd� | D ��}ttj�D ]}|| v s|�|�r#tj�|�||< q|S )Nc s s � | ]}|d V qdS )�.Nr )�.0r r r r � <genexpr>V s � z+_save_and_remove_modules.<locals>.<genexpr>)r- �listr r r, �pop)�names� orig_modules�prefixesr r r r �_save_and_remove_modulesT s �r; c C s� t |��h t|�}t|�}| h|�|�}t|�}|D ]}dtj|< qz>z |D ]}t|� q&W n tyI Y W t|� tj�|� W d � dS w t� | �W t|� tj�|� W d � S t|� tj�|� w 1 sow Y dS )a9 Import and return a module, deliberately bypassing sys.modules. This function imports and returns a fresh copy of the named Python module by removing the named module from sys.modules before doing the import. Note that unlike reload, the original module is not affected by this operation. *fresh* is an iterable of additional module names that are also removed from the sys.modules cache before doing the import. If one of these modules can't be imported, None is returned. *blocked* is an iterable of module names that are replaced with None in the module cache during the import to ensure that attempts to import them raise ImportError. The named module and any modules named in the *fresh* and *blocked* parameters are saved before starting the import and then reinserted into sys.modules when the fresh import is complete. Module and package deprecation messages are suppressed during this import if *deprecated* is True. This function will raise ImportError if the named module cannot be imported. N) r r6 r; r r � __import__r* �updater r) )r �fresh�blockedr1 r8 r9 r r r r �import_fresh_module] s2 � � ��r@ c @ �( e Zd ZdZdd� Zdd� Zdd� ZdS ) � CleanImporta, Context manager to force import to return a new module reference. This is useful for testing module-level behaviours, such as the emission of a DeprecationWarning on import. Use like this: with CleanImport("foo"): importlib.import_module("foo") # new reference c G sJ t j�� | _|D ]}|t jv r"t j| }|j|kr t j|j= t j|= qd S r )r r �copy�original_modules�__name__)�self� module_names� module_name�moduler r r �__init__� s ��zCleanImport.__init__c C � | S r r �rF r r r � __enter__� � zCleanImport.__enter__c G s t j�| j� d S r )r r r= rD �rF � ignore_excr r r �__exit__� s zCleanImport.__exit__N�rE � __module__� __qualname__�__doc__rJ rM rQ r r r r rB � s rB c @ rA ) � DirsOnSysPatha� Context manager to temporarily add directories to sys.path. This makes a copy of sys.path, appends any directories given as positional arguments, then reverts sys.path to the copied settings when the context ends. Note that *all* sys.path modifications in the body of the context manager, including replacement of the object, will be reverted at the end of the block. c G s( t jd d � | _t j| _t j�|� d S r )r r �original_value�original_object�extend)rF �pathsr r r rJ � s zDirsOnSysPath.__init__c C rK r r rL r r r rM � rN zDirsOnSysPath.__enter__c G s | j t_| jtjd d �< d S r )rX r r rW rO r r r rQ � s zDirsOnSysPath.__exit__NrR r r r r rV � s rV c C s t j�� fS r )r r rC r r r r � modules_setup� s r[ c C s: dd� t j�� D �}t j�� t j�|� t j�| � d S )Nc S s" g | ] \}}|� d �r||f�qS )z encodings.)r, )r4 �k�vr r r � <listcomp>� s �z#modules_cleanup.<locals>.<listcomp>)r r �items�clearr= )� oldmodules� encodingsr r r �modules_cleanup� s rc )T)F)r r F)� contextlibr �importlib.utilr r" r r. r � os_helperr �contextmanagerr r r r' r) r; r@ �objectrB rV r[ rc r r r r �<module> s* 3 PK ! � � � , __pycache__/threading_helper.cpython-310.pycnu �[��� o p̦i� � @ s� d dl Z d dlZd dlZd dlZd dlZd dlZd dlmZ dd� Zdd� Z dd� Z ej dd d ��Z dd d �Z ej dd d��ZG dd� d�ZdS )� N)�supportc C s t �� tj�� fS �N)�_thread�_count� threading� _dangling�copy� r r �4/usr/lib/python3.10/test/support/threading_helper.py�threading_setup s r c G s� d}t |�D ]L}t�� tjf}|| kr d S |sGdt_|d }t�d|d | d � d|d � dt|�� d�� |D ] }t�d |��� q:d }d }t � d � t� � qd S ) N�d T� z&threading_cleanup() failed to cleanup r z threads (count: z , dangling: �)zDangling thread: �{�G�z�?) �ranger r r r r �environment_altered� print_warning�len�time�sleep� gc_collect)�original_values� _MAX_COUNT�count�values�dangling_threads�threadr r r �threading_cleanup s, �� � �r c s t �� �� fdd��}|S )z�Use this function when threads are being used. This will ensure that the threads are cleaned up even when the test fails. c s$ t � }z � | � W t|� S t|� w r )r r )�args�key��funcr r � decorator: s z reap_threads.<locals>.decorator)� functools�wraps)r! r" r r r � reap_threads6 s r% c c s � | du rt j} t�� }zCdV W t�� }|| } t�� }||kr$dS t�� |krFt�� | }d|| � d|d�d|� d|� d� }t|��t�d � t �� qt�� }|| } t�� }||krc w t�� |kr�t�� | }d|| � d|d�d|� d|� d� }t|��t�d � t �� qY) aH bpo-31234: Context manager to wait until all threads created in the with statement exit. Use _thread.count() to check if threads exited. Indirectly, wait until threads exit the internal t_bootstrap() C function of the _thread module. threading_setup() and threading_cleanup() are designed to emit a warning if a test leaves running threads in the background. This context manager is designed to cleanup threads started by the _thread.start_new_thread() which doesn't allow to wait for thread exit, whereas thread.Thread has a join() method. NTz!wait_threads() failed to cleanup z threads after �.1fz seconds (count: z , old count: r r ) r � SHORT_TIMEOUTr r r � monotonic�AssertionErrorr r )�timeout� old_count� start_time�deadliner �dt�msgr r r �wait_threads_exitD sZ � ��� ��� ��� �r0 c C s: |du rt j}| �|� | �� rd|d�d�}t|��dS )zcJoin a thread. Raise an AssertionError if the thread is still alive after timeout seconds. Nz failed to join the thread in r& z seconds)r r' �join�is_aliver) )r r* r/ r r r � join_threadi s �r3 c c s, � dd l }t| �} g }z�z| D ] }|�� |�|� qW n tjr/tdt| �t|�f � � d V W zX|r:|� t� � }t dd�D ]/}|d7 }|D ]}|� t |t� � d�� qKdd� |D �}|se ntjrrtd t|�|f � qCW d d� |D �}|r�|� tj� td t|� ��d S d d� |D �}|r�|� tj� td t|� ��w zW|r�|� t� � }t dd�D ]/}|d7 }|D ]}|� t |t� � d�� q�dd� |D �}|s� ntjr�td t|�|f � q�W d d� |D �}|r�|� tj� td t|� ��w d d� |D �}|�r|� tj� td t|� ��w ) Nr z/Can't start %d threads, only %d threads startedr � �< r c S � g | ]}|� � r|�qS r �r2 ��.0�tr r r � <listcomp>� � z!start_threads.<locals>.<listcomp>z7Unable to join %d threads during a period of %d minutesc S r6 r r7 r8 r r r r; � r< zUnable to join %d threads)� faulthandler�list�start�appendr �verbose�printr r r( r r1 �max�dump_traceback�sys�stdoutr) )�threads�unlockr= �startedr: �endtimer* r r r � start_threadsu s� � �� �� �� � �� � rK c @ s0 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd S ) �catch_threading_exceptiona Context manager catching threading.Thread exception using threading.excepthook. Attributes set when an exception is caught: * exc_type * exc_value * exc_traceback * thread See threading.excepthook() documentation for these attributes. These attributes are deleted at the context manager exit. Usage: with threading_helper.catch_threading_exception() as cm: # code spawning a thread which raises an exception ... # check the thread exception, use cm attributes: # exc_type, exc_value, exc_traceback, thread ... # exc_type, exc_value, exc_traceback, thread attributes of cm no longer # exists at this point # (to avoid reference cycles) c C s" d | _ d | _d | _d | _d | _d S r )�exc_type� exc_value� exc_tracebackr � _old_hook��selfr r r �__init__� s z"catch_threading_exception.__init__c C s$ |j | _ |j| _|j| _|j| _d S r )rM rN rO r )rR r r r r �_hook� s z catch_threading_exception._hookc C s t j| _| jt _| S r )r � excepthookrP rT rQ r r r � __enter__� s z#catch_threading_exception.__enter__c G s | j t_| `| `| `| `d S r )rP r rU rM rN rO r )rR �exc_infor r r �__exit__� s z"catch_threading_exception.__exit__N)�__name__� __module__� __qualname__�__doc__rS rT rV rX r r r r rL � s rL r )r � contextlibr# rE r r �testr r r r% �contextmanagerr0 r3 rK rL r r r r �<module> s $ %PK ! �$���� �� $ __pycache__/__init__.cpython-310.pycnu �[��� o p̦i� � @ s� d Z edkr ed��ddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl Z ddl Z ddlmZ zddlmZ W n eyO dZY nw g d�Zd Zejd krcd ejv rcd Znejd krjd ZdZdZdZG dd� de�ZG dd� de�ZG dd� de�Z G dd� de�Z G dd� de j �Z dd � Z d d � Z!d d � Z"dZ#dZ$da%da&dZ'd!Z(da)d"d#� Z*d$d%� Z+d&d'� Z,d(d)� Z-d*d+� Z.�d d,d-�Z/d.d/� Z0d0d1� Z1d2d3� Z2d4d5� Z3d!d!d!d6�d7d8�Z4�d d!d!d!d6�d9d:�Z5d;d<� Z6d=Z7d>Z8e �9e:�;d?��<d@�dA�Z=�d dCdD�Z>�d dFdG�Z?�d dIdJ�Z@�ddLdM�ZAe �9edN�ZBej�<dO�ZCeDedP�ZEejdQv�r<eE�r9dRndSZFndZFdTZGd!ZHd!ZIejJ�KejJ�LeM��ZNejJ�KeN�ZOejJ�PeOdU�ZQdVdW� ZR�d dXdY�ZSdZd[� ZT�dddd]�d^d_�ZUd`da� ZVejWdbdc� �ZXddde� ZYdfdg� ZZdhdi� Z[djdk� Z\ejWdldm� �Z]dndo� Z^dpZ_dqZ`eDedr��r�dse_ Z_dtZ`e_du Zadvdw� Zbdxdy� ZcdzZdd{Zed|d}� ZfejWd~d� �Zgd�d�� Zhd�Zid�ei Zjd�ej Zkd�ej ZlejmZnd�d�� ZoG d�d�� d��Zp�dd�d��Zqd�d�� ZrG d�d�� d��Zsd�d�� Ztd�d�� Zud�d�� Zv�d d�d��Zwd�d�� Zxd�d�� Zyd�d�� Zzd�d�� Z{d�d�� Z|d�d�� Z}da~dada�d�d�� Z�d�d�� Z��dd�d��Z�d�d�� Z�d�d�� Z�d�d�� Z�ey� �oNejd k�oNe ��d�� Z�e�j du�oWe� Z�e �9e�d��Z��dd�d��Z�d�d�� Z�d!a�d�d�� Z�ejWd�d�� �Z�ejWd�d�� �Z�d�d�� Z�d�d�� Z�G d�d d�e��Z�da�d�dĄ Z�G d�dƄ dƃZ�d�dȄ Z�d�dʜd�d̄Z� � ɐdd�d΄Z��dd�dЄZ�G d�d҄ d҃Z�d�dԄ Z�ejWd�dք �Z�d�d Z��dd�dڄZ�g fd�d܄Z�da�d�dބ Z�ejWd�d� �Z�G d�d� d�Z�d�d� Z�G d�d� d�Z�e�� Z�G d�d� d�Z�e�� Z�ej�G d�d� d��Z�e�� Z�ej�G d�d� d��Z�e�� Z�d�d� Z�ej�j�Z�e�d�v �s)J �d�d� Z�G d�d� d�Z�dd�d�d��Z�d�d�� Z�ejW�dd�d���Z�d�d�� Z�d�e�d�e��d e�f�d�d�Z��de��d df�d�d�Z�ejW�d�d� �Z��d e�e� f�d�d �Z�dS ( z7Supporting definitions for the Python regression tests.z test.supportz.support must be imported from the test package� N� )�get_test_runner)�unicode_legacy_string)B� PIPE_MAX_SIZE�verbose� max_memuse� use_resources�failfast�Error� TestFailed� TestDidNotRun�ResourceDenied�record_original_stdout�get_original_stdout�captured_stdout�captured_stdin�captured_stderr�is_resource_enabled�requires�requires_freebsd_version�requires_linux_version�requires_mac_ver�check_syntax_error�BasicTestRunner� run_unittest� run_doctest� requires_gzip� requires_bz2� requires_lzma� bigmemtest�bigaddrspacetest� cpython_only� get_attribute�requires_IEEE_754� requires_zlib�anticipate_failure�load_package_tests�detect_api_mismatch� check__all__� skip_if_buggy_ucrt_strfptime� check_disallow_instantiation�check_sanitizer�skip_if_sanitizer� is_jython� is_android�check_impl_detail� unix_shell�setswitchinterval�open_urlresource� reap_children�run_with_locale� swap_item�findfile� swap_attr�Matcher� set_memlimit�SuppressCrashReport�sortdict� run_with_tz�PGO�missing_compiler_executable� ALWAYS_EQ�NEVER_EQ�LARGEST�SMALLEST�LOOPBACK_TIMEOUT�INTERNET_TIMEOUT� SHORT_TIMEOUT� LONG_TIMEOUTg @�win32z 32 bit (ARM)� �vxworksg N@g >@g �r@c @ � e Zd ZdZdS )r z*Base class for regression test exceptions.N��__name__� __module__� __qualname__�__doc__� rP rP �,/usr/lib/python3.10/test/support/__init__.pyr g � r c @ rJ )r � Test failed.NrK rP rP rP rQ r j rR r c s( e Zd ZdZ� fdd�Zdd� Z� ZS )�TestFailedWithDetailsrS c s& || _ || _|| _t� �|||� d S �N)�msg�errors�failures�super�__init__)�selfrV rW rX �� __class__rP rQ rZ o s z TestFailedWithDetails.__init__c C s | j S rU )rV �r[ rP rP rQ �__str__u s z TestFailedWithDetails.__str__)rL rM rN rO rZ r_ � __classcell__rP rP r\ rQ rT m s rT c @ rJ )r z Test did not run any subtests.NrK rP rP rP rQ r x rR r c @ rJ )r z�Test skipped because it requested a disallowed resource. This is raised when a test calls requires() for a resource that has not be enabled. It is used to distinguish between expected and unexpected skips. NrK rP rP rP rQ r { rR r c C s | rt jS dd� S )z�Decorator to mark a test that is known to be broken in some cases Any use of this decorator should have a comment identifying the associated tracker issue. c S � | S rU rP ��frP rP rQ �<lambda>� � z$anticipate_failure.<locals>.<lambda>)�unittest�expectedFailure)� conditionrP rP rQ r% � s r% c C sF |du rd}t j�t j�t j�t���}|j| ||d�}|�|� |S )z�Generic load_tests implementation for simple test packages. Most packages can implement load_tests using this function as follows: def load_tests(*args): return load_package_tests(os.path.dirname(__file__), *args) Nztest*)� start_dir� top_level_dir�pattern)�os�path�dirname�__file__�discover�addTests)�pkg_dir�loader�standard_testsrk �top_dir� package_testsrP rP rQ r& � s ��� r& c C s2 zt | |�}W |S ty t�d| |f ��w )z?Get an attribute, raising SkipTest if AttributeError is raised.z object %r has no attribute %r)�getattr�AttributeErrorrf �SkipTest)�obj�name� attributerP rP rQ r" � s ��r" Fc C s | a d S rU )�_original_stdout)�stdoutrP rP rQ r � s r c C s t ptjS rU )r} �sysr~ rP rP rP rQ r � � r c G st z||� W S t y9 } z(tdkr$td|jj|f � td|j|f � t�| tj� ||� W Y d }~S d }~ww )N� z%s: %sz re-run %s%r) �OSErrorr �printr] rL rl �chmod�stat�S_IRWXU)rm �func�args�errrP rP rQ � _force_run� s ��r� c s t td�rtjS dd l} d }tj�d�r| �� rd}n�tj�d�rpdd l�dd l�d}d}G �fdd�d�j �}�j j }|� � }|sF�� � �|� }�j�� }|�||��|���|���|��} | sf�� � �t|j|@ �sod}nHtjd kr�dd lm} m� m} m } dd lm} | �| d ��}|�� dkr�d }n!G � fdd�d| �}|� }| |�}|� |�dk s�|� |�dk r�d}|s�zddl m } |� }|� � |�!� |�"� W n- t#y� } z!t$|�}t%|�dkr�|d d� d }d�&t'|�j(|�}W Y d }~nd }~ww |t_)| t_tjS )N�resultr �winz(gui is not available on Windows IoT Corer c s. e Zd Zd� jjfd� jjfd� jjfgZdS )z*_is_gui_available.<locals>.USEROBJECTFLAGS�fInherit� fReserved�dwFlagsN)rL rM rN �wintypes�BOOL�DWORD�_fields_rP )�ctypesrP rQ �USEROBJECTFLAGS� s �r� z,gui not available (WSF_VISIBLE flag not set)�darwin)�cdll�c_int�pointer� Structure)� find_library�ApplicationServicesz0gui tests cannot run without OS X window managerc s e Zd Zd� fd� fgZdS )z._is_gui_available.<locals>.ProcessSerialNumber� highLongOfPSN� lowLongOfPSNN)rL rM rN r� rP )r� rP rQ �ProcessSerialNumber� s �r� z#cannot run without OS X gui process)�Tk�2 z [...]z Tk unavailable due to {}: {})*�hasattr�_is_gui_availabler� �platformr � startswith� win32_is_iotr� �ctypes.wintypesr� �windll�user32�GetProcessWindowStation�WinErrorr� r� �GetUserObjectInformationW�byref�sizeof�boolr� r� r� r� � ctypes.utilr� � LoadLibrary�CGMainDisplayID�GetCurrentProcess�SetFrontProcess�tkinterr� �withdraw�update�destroy� Exception�str�len�format�typerL �reason)r� r� � UOI_FLAGS� WSF_VISIBLEr� �dll�h�uof�needed�resr� r� r� r� � app_servicesr� �psn�psn_pr� �root�e� err_stringrP )r� r� rQ r� � sx �� ���r� c C s t du p| t v S )z�Test whether a resource is enabled. Known resources are set by regrtest.py. If not running under regrtest.py, all resources are assumed enabled unless use_resources has been set. N)r ��resourcerP rP rQ r s r c C s@ t | �s|du r d| }t|��| dkr t� s ttj��dS dS )z@Raise ResourceDenied if the specified resource is not available.Nz"Use of the %r resource not enabled�gui)r r r� r� )r� rV rP rP rQ r s �r c C s� ddl }d�tt|��}|�� �dd�d }|�� | kr9z ttt|�d���}W n t y3 d}Y nw ||k }nd}t � || � d|� d|� ��S ) z�Decorator raising SkipTest if the OS is `sysname` and the version is less than `min_version`. For example, @_requires_unix_version('FreeBSD', (7, 2)) raises SkipTest if the FreeBSD version is less than 7.2. r N�.�-r Fz version z or higher required, not ) r� �join�mapr� �release�split�system�tuple�int� ValueErrorrf �skipIf)�sysname� min_versionr� �min_version_txt� version_txt�version�skiprP rP rQ �_requires_unix_version( s" � ��r� c G � t d| �S )z�Decorator raising SkipTest if the OS is FreeBSD and the FreeBSD version is less than `min_version`. For example, @requires_freebsd_version(7, 2) raises SkipTest if the FreeBSD version is less than 7.2. �FreeBSD�r� �r� rP rP rQ r C � r c G r� )z�Decorator raising SkipTest if the OS is Linux and the Linux version is less than `min_version`. For example, @requires_linux_version(2, 6, 32) raises SkipTest if the Linux version is less than 2.6.32. �Linuxr� r� rP rP rQ r L r� r c � � fdd�}|S )z�Decorator raising SkipTest if the OS is Mac OS X and the OS X version if less than min_version. For example, @requires_mac_ver(10, 5) raises SkipTest if the OS X version is lesser than 10.5. c s" t �� �� �fdd��}�|_|S )Nc s� t jdkr:dd l}|�� d }z ttt|�d���}W n ty$ Y nw |�k r:d�tt ���}t � d||f ��� | i |��S )Nr� r r� z&Mac OS X %s or higher required, not %s) r r� �mac_verr� r� r� r� r� r� r� rf ry )r� �kwr� r� r� r� )r� r� rP rQ �wrapper] s ���z4requires_mac_ver.<locals>.decorator.<locals>.wrapper)� functools�wrapsr� �r� r� r� �r� rQ � decorator\ s z#requires_mac_ver.<locals>.decoratorrP )r� r� rP r� rQ r U s r ��address�memory�ubc C sx | s |s |s t d��t�d�pd}t�d�pd}d|v p d|v }d|v p'd|v }d|v p/d |v }|r4|p;| o7|p;|o;|S ) z9Returns True if Python is compiled with sanitizer supportz3At least one of address, memory, or ub must be True�CFLAGS� � CONFIG_ARGSz-fsanitize=memoryz--with-memory-sanitizerz-fsanitize=addressz-fsanitize=undefinedz#--with-undefined-behavior-sanitizer)r� � sysconfig�get_config_var)r� r� r� �_cflags� _config_args�memory_sanitizer�address_sanitizer� ub_sanitizerrP rP rQ r+ r s$ �����r+ c C s" | sd} t |||d�}t�|| �S )z>Decorator raising SkipTest if running with a sanitizer active.z"not working with sanitizers activer� )r+ rf r� )r� r� r� r� r� rP rP rQ r, � s r, c s t �� �� fdd��}|S )z5Skip the test on TLS certificate validation failures.c sF z � | i |�� W d S t y" } z dt|�v r t�d��� d }~ww )N�CERTIFICATE_VERIFY_FAILEDz.system does not contain necessary certificates)r� r� rf ry )r� �kwargsr� rb rP rQ �dec� s ��z&system_must_validate_cert.<locals>.dec)r� r� )rc r rP rb rQ �system_must_validate_cert� s r i @ i �double�IEEEz test requires IEEE 754 doubles� requires zlibc C �0 zdd l }W n ty d }Y nw t�|| �S �Nr )�zlib� ImportErrorrf � skipUnless)r� r rP rP rQ r$ � � � r$ � requires gzipc C r r )�gzipr rf r )r� r rP rP rQ r � r r � requires bz2c C r r )�bz2r rf r )r� r rP rP rQ r � r r � requires lzmac C r r )�lzmar rf r )r� r rP rP rQ r � r r z requires legacy Unicode C API�java�getandroidapilevel)rG rI z/system/bin/shz/bin/shzhttp://www.pythontest.net�datac C sX t jdkrdS ddl}d}| � d�}|�� \}}t|�|d�� t|� td| � dS )zOAssure user that loud errors generated by macOS libc's malloc are expected.r� Nr z NOTICE z� may generate "malloc can't allocate region" warnings on macOS systems. This behavior is known. Do not report a bug unless tests are also failing. See bpo-40928.r� )r r� �shutil�get_terminal_sizer� �center)� test_namer rV �detail�padding�_rP rP rQ �darwin_malloc_err_warning� s r c C sb t j�| �r| S |durt j�|| �} tgtj }|D ]}t j�|| �}t j�|�r.| S q| S )a[ Try to find a file on sys.path or in the test directory. If it is not found the argument passed to the function is returned (this does not necessarily signal failure; could still be the legitimate path). Setting *subdir* indicates a relative path to use to find the file rather than looking directly in the path directories. N)rl rm �isabsr� � TEST_HOME_DIRr �exists)�filename�subdirrm �dn�fnrP rP rQ r6 s r6 c C s, t | �� �}dd� |D �}d�|�}d| S )z%Like repr(dict), but in sorted order.c S s g | ]}d | �qS )z%r: %rrP )�.0�pairrP rP rQ � <listcomp> � z sortdict.<locals>.<listcomp>z, z{%s})�sorted�itemsr� )�dictr( � reprpairs� withcommasrP rP rQ r; s r; r� )�lineno�offsetc C s� | � t|��}t|dd� W d � n1 sw Y |j}| �|j� |d ur0| �|j|� | �|j� |d urC| �|j|� d S d S )Nz <test string>�exec)�assertRaisesRegex� SyntaxError�compile� exception�assertIsNotNoner, � assertEqualr- )�testcase� statement�errtextr, r- �cmr� rP rP rQ r s � �r c s� dd l }dd l}ddlm} zdd l}W n ty d }Y nw ��dd ��|j�| �d � d�d }t j � t |�}� ��fdd �}t j �|�rV||�} | d urR| S ||� td � tretd | t� d � |j�� } |rr| j�d � | j| td�} |r�| j�d�dkr�|j| d�} z,t|d��} | � � } | r�| � | � | � � } | s�W d � n1 s�w Y W | � � n| � � w ||�} | d ur�| S t d| ��)Nr r )�unlink�checkr� �/���c sD t | g� �R i ���}�d u r|S �|�r |�d� |S |�� d S r )�open�seek�close)r" rc �r� r: r� rP rQ �check_valid_file8 s z*open_urlresource.<locals>.check_valid_file�urlfetchz fetching %s ...��file)zAccept-Encodingr ��timeoutzContent-Encodingr )�fileobj�wbzinvalid resource %r) �urllib.request� urllib.parse� os_helperr9 r r �pop�parse�urlparser� rl rm r� � TEST_DATA_DIRr r r r� r �request� build_opener� addheaders�appendr= rD �headers�get�GzipFile�read�writer? r ) �urlr� r� �urllibr9 r r r" rA rc �opener�out�srP r@ rQ r2 * sP � �� �� r2 c c sR � ddl }tt| �}tt| |�� � ztt| �V W tt| |� dS tt| |� w )z�Return a context manager used by captured_stdout/stdin/stderr that temporarily replaces the sys stream *stream_name* with a StringIO.r N)�iorw r �setattr�StringIO)� stream_namer^ � orig_stdoutrP rP rQ �captured_outputa s � rc c C � t d�S )z�Capture the output of sys.stdout: with captured_stdout() as stdout: print("hello") self.assertEqual(stdout.getvalue(), "hello\n") r~ �rc rP rP rP rQ r m � r c C rd )z�Capture the output of sys.stderr: with captured_stderr() as stderr: print("hello", file=sys.stderr) self.assertEqual(stderr.getvalue(), "hello\n") �stderrre rP rP rP rQ r v rf r c C rd )a Capture the input to sys.stdin: with captured_stdin() as stdin: stdin.write('hello\n') stdin.seek(0) # call test code that consumes from sys.stdin captured = input() self.assertEqual(captured, "hello") �stdinre rP rP rP rQ r s r c C s2 ddl } | �� trt�d� | �� | �� dS )a� Force as many objects as possible to be collected. In non-CPython implementations of Python, this is needed because timely deallocation is not guaranteed by the garbage collector. (Even in CPython this can be the case in case of reference cycles.) This means that __del__ methods may be called later than expected and weakrefs may remain alive for longer than expected. This function tries its best to force all garbage objects to disappear. r N皙�����?)�gc�collectr- �time�sleep)rj rP rP rQ � gc_collect� s rn c c sH � dd l } | �� }| �� zd V W |r| �� d S d S |r#| �� w w r )rj � isenabled�disable�enable)rj �have_gcrP rP rQ � disable_gc� s � � �rs c C s6 t �d�pd} d}| �� D ] }|�d�r|}q |dvS )z,Find if Python was built with optimizations.� PY_CFLAGSr� z-O)r� z-O0z-Og)r� r� r� r� )�cflags� final_opt�optrP rP rQ �python_is_optimized� s �rx �nP�0n� getobjects�2P�0P�nc C � dd l }|�t| t �S r )�struct�calcsize�_header�_align��fmtr� rP rP rQ � calcobjsize� � r� c C r r )r� r� �_vheaderr� r� rP rP rQ � calcvobjsize� r� r� i @ i c C sp dd l }t�|�}t|�tkr|jt@ s!t|�tkr&t|�jt@ r&||j7 }dt|�||f }| �|||� d S )Nr z&wrong size for %s: got %d, expected %d) �_testinternalcapir � getsizeofr� � __flags__�_TPFLAGS_HEAPTYPE�_TPFLAGS_HAVE_GC�SIZEOF_PYGC_HEADr4 )�test�o�sizer� r� rV rP rP rQ � check_sizeof� s �r� c g s� � zdd l }t|| �}|�|�}W n ty � d }}Y n|D ]}z |�||� W n Y q$zd V W |rF|rH|�||� d S d S d S |rU|rV|�||� w w w r )�localerw � setlocalerx )�catstr�localesr� �category� orig_locale�locrP rP rQ r4 � s, � ��r4 c r� )Nc s" � �fdd�}� j |_ � j|_|S )Nc s� zt j}W n ty t�d��w dtjv r tjd }nd }�tjd< |� z� | i |��W |d u r8tjd= n|tjd< t �� S |d u rKtjd= n|tjd< t �� w )Nztzset required�TZ)rl �tzsetrx rf ry rl �environ)r� �kwdsr� �orig_tz)r� �tzrP rQ �inner� s( � � z-run_with_tz.<locals>.decorator.<locals>.inner)rL rO )r� r� �r� r� rQ r� � s z run_with_tz.<locals>.decoratorrP )r� r� rP r� rQ r< � s r< i � r� � c C s� dt tdt d�}t�d| tjtjB �}|d u r td| f ��tt|� d��||� d�� � �}|a |t kr9t }|t d k rFtd| f ��|ad S )Nr� )�k�m�g�tz(\d+(\.\d+)?) (K|M|G|T)b?$zInvalid memory limit %rr � z$Memory limit %r too low to be useful)�_1M�_1G�re�match� IGNORECASE�VERBOSEr� r� �float�group�lower�real_max_memuse�MAX_Py_ssize_t�_2Gr )�limit�sizesr� �memlimitrP rP rQ r9 s" � �$ r9 c @ �( e Zd ZdZdd� Zdd� Zdd� ZdS ) �_MemoryWatchdogz`An object which periodically watches the process' memory consumption and prints it out. c C s dj t�� d�| _d| _d S )Nz/proc/{pid}/statm)�pidF)r� rl �getpid�procfile�startedr^ rP rP rQ rZ 7 s z_MemoryWatchdog.__init__c C s� dd l }zt| jd�}W n! ty- } z|�d�|�t� tj� � W Y d }~d S d }~ww dd l }|� t d�}|j tj |g||jd�| _W d � n1 sPw Y d| _d S )Nr �rz!/proc not available for stats: {}zmemory_watchdog.py)rh rg T)�warningsr= r� r� �warnr� �RuntimeWarningr rg �flush� subprocessr6 �Popen� executable�DEVNULL� mem_watchdogr� )r[ r� rc r� r� �watchdog_scriptrP rP rQ �start; s( � �� � � z_MemoryWatchdog.startc C s" | j r| j�� | j�� d S d S rU )r� r� � terminate�waitr^ rP rP rQ �stopM s �z_MemoryWatchdog.stopN)rL rM rN rO rZ r� r� rP rP rP rQ r� 2 s r� Tc s � ��fdd�}|S )at Decorator for bigmem tests. 'size' is a requested size for the test (in arbitrary, test-interpreted units.) 'memuse' is the number of bytes per unit for the test, or a good estimate of it. For example, a test that needs two byte buffers, of 4 GiB each, could be decorated with @bigmemtest(size=_4G, memuse=2). The 'size' argument is normally passed to the decorated test method as an extra argument. If 'dry_run' is true, the value passed to the test method may be less than the requested value. If 'dry_run' is false, it means the test doesn't support dummy runs when -M is not specified. c s �� �fdd����_ ��_�S )Nc s� �j }�j}ts d}n|}ts� s"t|| k r"t�d|| d ��tr=tr=t� tdj|| d d�� t� }|� � nd }z �| |�W |rL|� � S S |rT|� � w w )Ni �'not enough memory: %.1fG minimum needed� @z* ... expected peak memory use: {peak:.1f}G)�peak) r� �memuser� rf ry r r� r� r� r� r� )r[ r� r� �maxsize�watchdog)�dry_runrc r� rP rQ r� a s6 �� � � �z.bigmemtest.<locals>.decorator.<locals>.wrapper)r� r� rb �r� r� r� �rc r� rQ r� ` s z bigmemtest.<locals>.decoratorrP )r� r� r� r� rP r� rQ r S s !r c r� )z0Decorator for tests that fill the address space.c s< t tk rtdkrt dkrt�d��t�dtd ��� | �S )Nl ���� l z-not enough memory: try a 32-bit build insteadr� r� )r r� rf ry r^ rb rP rQ r� � s ���z!bigaddrspacetest.<locals>.wrapperrP r� rP rb rQ r � s r c @ s e Zd Zdd� ZdS )r c C s t �� }||� |S rU )rf � TestResult)r[ r� r� rP rP rQ �run� � zBasicTestRunner.runN)rL rM rN r� rP rP rP rQ r � s r c C ra rU rP )rz rP rP rQ �_id� � r� c C s6 | dkr t � s t�t j�S t| �rtS t�d�| ��S )Nr� z resource {0!r} is not enabled)r� rf r� r� r r� r� r� rP rP rQ �requires_resource� s r� c C s t dd�| �S )z9 Decorator for tests only applicable on CPython. T)�cpython)� impl_detail�r� rP rP rQ r! � s r! c K sZ t di |��r tS | d u r(t|�\}}|rd} nd} t|�� �}| �d�|��} t�| �S )Nz*implementation detail not available on {0}z%implementation detail specific to {0}z or rP ) r/ r� � _parse_guardsr' �keysr� r� rf r� )rV �guards� guardnames�defaultrP rP rQ r� � s r� c C sH | sddidfS t | �� �d }t | �� �|gt| � ks J �| | fS )Nr� TFr )�list�valuesr� )r� �is_truerP rP rQ r� � s r� c K s t | �\} }| �tjj|�S )a5 This function returns True or False depending on the host platform. Examples: if check_impl_detail(): # only on CPython (default) if check_impl_detail(jython=True): # only on Jython if check_impl_detail(cpython=False): # everywhere except on CPython )r� rU r �implementationr{ )r� r� rP rP rQ r/ � s r/ c s( t td�s� S t�� �� fdd��}|S )zEDecorator to temporarily turn off tracing for the duration of a test.�gettracec s: t �� }zt �d � � | i |��W t �|� S t �|� w rU )r r� �settrace)r� r� �original_tracer� rP rQ r� � s zno_tracing.<locals>.wrapper)r� r r� r� r� rP r� rQ � no_tracing� s r� c C s t t| ��S )a Decorator for tests which involve reference counting. To start, the decorator does not run the test if is not run by CPython. After that, any trace function is unset during the test to prevent unexpected refcounts caused by the trace function. )r� r! r� rP rP rQ � refcount_test� s r� c C sN g }| j D ] }t|tj�rt||� |�|� q||�r!|�|� q|| _ dS )z>Recursively filter test cases in a suite based on a predicate.N)�_tests� isinstancerf � TestSuite� _filter_suiterS )�suite�pred�newtestsr� rP rP rQ r� � s � r� c C s� t tjttdud�}|�| �}tdurt�|�� � |js"|j s"t �|� � sht |j �dkr8|js8|j d d }nt |j�dkrJ|j sJ|jd d }nd}tsR|d7 }dd� |j D �}d d� |jD �}t|||��dS ) z2Run tests from a unittest.TestSuite-derived class.N)� verbosity�capture_outputr r zmultiple errors occurredz!; run in verbose mode for detailsc S � g | ] \}}t |�|f�qS rP �r� �r# �tc�exc_strrP rP rQ r% � z _run_suite.<locals>.<listcomp>c S r� rP r� r� rP rP rQ r% r� )r r r~ r �junit_xml_listr� rS �get_xml_element�testsRun�skippedr � wasSuccessfulr� rW rX rT )r� �runnerr� r� rW rX rP rP rQ � _run_suite� s( � �r c C s t d u rdS t | �� �S �NT)�_match_test_func�idr� rP rP rQ � match_test s r c C s d| v o t �d| � S )Nr� z[?*\[\]])r� �search)rk rP rP rQ �_is_full_match_test s r c s� | d u rd} |d u r d}d � �| t krt| �\} � |tkr$t|�\}�t| �a t|�a� d us4�d ur?� �fdd�}|ad S d S )NrP c s* d}d}� r � | �}�r�| �}|o| S )NTFrP )�test_id�accept�ignore�� accept_func� ignore_funcrP rQ �match_function= s z'set_match_tests.<locals>.match_function)�_accept_test_patterns�_compile_match_function�_ignore_test_patternsr� r )�accept_patterns�ignore_patternsr rP r rQ �set_match_tests( s �r c sr | s d }d} | |fS t tt| ��rt| �j}| |fS dd l}d�t|j| ��}t� |�j � � fdd�}|}| |fS )NrP r �|c s � | �rdS t t� | �d���S )NTr� )�anyr� r� )r �� regex_matchrP rQ �match_test_regexY s z1_compile_match_function.<locals>.match_test_regex) �allr� r �set� __contains__�fnmatchr� � translater� r1 r� )�patternsr� r �regexr rP r rQ r I s � � r c G s� t jt jf}t �� }| D ]/}t|t�r(|tjv r$|�t �tj| �� q t d��t||�r3|�|� q |�t � |�� q t |t � t |� dS )z1Run tests from unittest.TestCase-derived classes.z)str arguments must be keys in sys.modulesN)rf r� �TestCaser� r� r �modules�addTest� findTestCasesr� � makeSuiter� r r )�classes� valid_typesr� �clsrP rP rQ r i s r c C � dS )z,Just used to check if docstrings are enabledNrP rP rP rP rQ �_check_docstrings� re r, �WITH_DOC_STRINGSztest requires docstringsc C s` ddl }|du r t}nd}|j| ||d�\}}|r!td||f ��tr,td| j|f � ||fS )a Run doctest on the given module. Return (#failures, #tests). If optional argument verbosity is not specified (or is None), pass support's belief about verbosity on to doctest. Else doctest's usual behavior is used (it searches sys.argv for -v). r N)r � optionflagsz%d of %d doctests failedz,doctest (%s) ... %d tests with zero failures)�doctestr �testmodr r� rL )�moduler� r. r/ rc r� rP rP rQ r � s �r c C s( | � � D ] }td|� �tjdd� qd S )Nz Warning -- T)rD r� )� splitlinesr� r � __stderr__)rV �linerP rP rQ � print_warning� s �r5 c C sf t td�r t td�s dS z t�dtj�\} }W n ty" Y dS w | dkr)dS td| � �� daq )z�Use this function at the end of test_main() whenever sub-processes are started. This will help ensure that no extra children (zombies) stick around to hog resources and create problems when looking for refleaks. �waitpid�WNOHANGNTr< r z%reap_children() reaped child process )r� rl r6 r7 r� r5 �environment_altered)r� �statusrP rP rQ r3 � s ��r3 c c s� � t | |�r%t| |�}t| ||� z |V W t| ||� dS t| ||� w t| ||� zdV W t | |�r<t| |� dS dS t | |�rIt| |� w w )a� Temporary swap out an attribute with a new object. Usage: with swap_attr(obj, "attr", 5): ... This will set obj.attr to 5 for the duration of the with: block, restoring the old value at the end of the block. If `attr` doesn't exist on `obj`, it will be created and then deleted at the end of the block. The old value (or None if it doesn't exist) will be assigned to the target of the "as" clause, if there is one. N)r� rw r_ �delattr)rz �attr�new_val�real_valrP rP rQ r7 � s � � �r7 c c sr � || v r | | }|| |< z |V W || |< dS || |< w || |< zdV W || v r/| |= dS dS || v r8| |= w )a� Temporary swap out an item with a new object. Usage: with swap_item(obj, "item", 5): ... This will set obj["item"] to 5 for the duration of the with: block, restoring the old value at the end of the block. If `item` doesn't exist on `obj`, it will be created and then deleted at the end of the block. The old value (or None if it doesn't exist) will be assigned to the target of the "as" clause, if there is one. NrP )rz �itemr< r= rP rP rQ r5 � s � �r5 c C � ddl } | �� S )znReturn a list of command-line arguments reproducing the current settings in sys.flags and sys.warnoptions.r N)r� � _args_from_interpreter_flags�r� rP rP rQ �args_from_interpreter_flags � rB c C r? )zgReturn a list of command-line arguments reproducing the current optimization settings in sys.flags.r N)r� �"_optim_args_from_interpreter_flagsrA rP rP rQ �!optim_args_from_interpreter_flags rC rE c @ � e Zd ZdZdd� Zdd� ZdS )r8 )rV �messagec K s< d}|D ]}|| }|� |�}| �|||�sd} |S q|S )a. Try to match a single dict with the supplied arguments. Keys whose values are strings and which are in self._partial_matches will be checked for partial (i.e. substring) matches. You can extend this scheme to (for example) do regular expression matching, etc. TF)rU � match_value)r[ �dr� r� r� �v�dvrP rP rQ �matches& s �zMatcher.matchesc C sL t |�t |�kr d}|S t |�tus|| jvr ||k}|S |�|�dk}|S )zT Try to match a single stored value (dv) with a supplied value (v). Fr )r� r� �_partial_matches�find)r[ r� rK rJ r� rP rP rQ rH 7 s ��zMatcher.match_valueN)rL rM rN rM rL rH rP rP rP rQ r8 " s r8 c C sX ddl }tdu r!tjdkr |�� d dkr t�� jdkr dandatr*t� d �| �S | S ) a- Skip decorator for tests that use buggy strptime/strftime If the UCRT bugs are present time.localtime().tm_zone will be an empty string, otherwise we assume the UCRT bugs are fixed See bpo-37552 [Windows] strptime/strftime return invalid results with UCRT version 17763.615 r NrG r �cp65001r� TFz!buggy MSVC UCRT strptime/strftime) r� � _buggy_ucrtr r� �getdefaultlocalerl � localtime�tm_zonerf r� )r� r� rP rP rQ r) E s r) c @ sj e Zd ZdZddd�Zejdkrdd� Zndd� Zd d � Zd d � Z d d� Z dd�dd�Z dd�dd�Z dS )� PythonSymlinkz3Creates a symlink for the current Python executableNc C sL ddl m} |p tj�|�| _g | _tj�tj �| _ g | _ d | _ | � � d S )Nr )�TESTFN)rK rU rl rm �abspath�link�_linked�realpathr r� �real� _also_link�_env�_platform_specific)r[ rW rU rP rP rQ rZ \ s zPythonSymlink.__init__rG c C s dd l }dd l}tj�| j�r tj�| j�s |�d�| _|�tj �}tj� |�}tj� | j �}| j � |tj�|tj�|��f� |� tj�|�|�d��D ]}| j � |tj�|tj�|��f� qMdd� tjD �| _tj� | j�| jd< t�d�r�tj� tj�| jd< d S d S )Nr zvcruntime*.dllc S s i | ] }|� � t�|��qS rP )�upperrl �getenv)r# r� rP rP rQ � <dictcomp> r� z4PythonSymlink._platform_specific.<locals>.<dictcomp>� PYTHONHOMET� PYTHONPATH)�glob�_winapirl rm �lexistsrZ r �GetModuleFileNamer � dllhandlern rW r[ rS r� �basename�escaper� r\ r� �is_python_buildro )r[ rc rd r� �src_dir�dest_dir�runtimerP rP rQ r] i s* � � �z PythonSymlink._platform_specificc C s d S rU rP r^ rP rP rQ r] � r� c C sJ t �| j| j� | j�| j� | jD ]\}}t �||� | j�|� q| S rU )rl �symlinkrZ rW rX rS r[ )r[ rZ rW rP rP rQ � __enter__� s zPythonSymlink.__enter__c C sV | j D ]%}zt�|� W q ty( } ztr td�||�� W Y d }~qd }~ww d S )Nzfailed to clean up {}: {})rX rl �remove�IOErrorr r� r� )r[ �exc_type� exc_value�exc_tbrW �exrP rP rQ �__exit__� s ���zPythonSymlink.__exit__c C sx dd l }|g|�}|j||j|j|d�}|�� }|j|kr:tr2tt|d �� tt|d �tj d� t d� |j���|S )Nr )r~ rg �envr rC z'unexpected return code: {0} (0x{0:08X})) r� r� �PIPE� communicate� returncoder r� �reprr rg � RuntimeErrorr� ) r[ �pythonr� rw rz r� �cmd�pr� rP rP rQ �_call� s � �zPythonSymlink._callr )rz c G s | � | j|d |�S rU )r� rZ �r[ rz r� rP rP rQ � call_real� s zPythonSymlink.call_realc G s | � | j|| j|�S rU )r� rW r\ r� rP rP rQ � call_link� s zPythonSymlink.call_linkrU ) rL rM rN rO rZ r r� r] ro rv r� r� r� rP rP rP rQ rT Z s rT c C s$ t pt}d}|r | S t�|�| �S )z;Skip decorator for tests not run in (non-extended) PGO taskz#Not run for (non-extended) PGO task)r= � PGO_EXTENDEDrf r� )r� �okrV rP rP rQ �skip_if_pgo_task� s r� rP )r c C s> t t| ��t t|�� }|r|t |�8 }t dd� |D ��}|S )a Returns the set of items in ref_api not in other_api, except for a defined list of items to be ignored in this check. By default this skips private attributes beginning with '_' but includes all magic methods, i.e. those starting and ending in '__'. c s s( � | ]}|� d �r|�d�r|V qdS )r �__N)r� �endswith)r# r� rP rP rQ � <genexpr>� s � ��z&detect_api_mismatch.<locals>.<genexpr>)r �dir)�ref_api� other_apir � missing_itemsrP rP rQ r' � s r' c C s� |du r |j f}nt|t�r|f}t|�}t|�D ])}|�d�s$||v r%qt||�}t|dd�|v s=t|d�sBt|tj �sB|� |� q| � |j |� dS )a) Assert that the __all__ variable of 'module' contains all public names. The module's public names (its API) are detected automatically based on whether they match the public name convention and were defined in 'module'. The 'name_of_module' argument can specify (as a string or tuple thereof) what module(s) an API could be defined in in order to be detected as a public API. One case for this is when 'module' imports part of its public API from other modules, possibly a C backend (like 'csv' and its '_csv'). The 'extra' argument can be a set of names that wouldn't otherwise be automatically detected as "public", like objects without a proper '__module__' attribute. If provided, it will be added to the automatically detected ones. The 'not_exported' argument can be a set of names that must not be treated as part of the public API even though their names indicate otherwise. Usage: import bar import foo import unittest from test import support class MiscTestCase(unittest.TestCase): def test__all__(self): support.check__all__(self, foo) class OtherTestCase(unittest.TestCase): def test__all__(self): extra = {'BAR_CONST', 'FOO_CONST'} not_exported = {'baz'} # Undocumented name. # bar imports part of its API from _bar. support.check__all__(self, bar, ('bar', '_bar'), extra=extra, not_exported=not_exported) Nr rM ) rL r� r� r r� r� rw r� �types� ModuleType�add�assertCountEqual�__all__)� test_caser1 �name_of_module�extra� not_exported�expectedr{ rz rP rP rQ r( � s" ) � � �r( c C s� zdd l }W n ty Y d S w |�|j|jB |jB |jB � t|d�rG|j|j |j fD ]}| r@|� ||j � |� ||j� q-|� |d� q-d S d S )Nr �CrtSetReportMode)�msvcrtr � SetErrorMode�SEM_FAILCRITICALERRORS�SEM_NOALIGNMENTFAULTEXCEPT�SEM_NOGPFAULTERRORBOX�SEM_NOOPENFILEERRORBOXr� �CRT_WARN� CRT_ERROR� CRT_ASSERTr� �CRTDBG_MODE_FILE�CrtSetReportFile�CRTDBG_FILE_STDERR)r r� r� rP rP rQ �suppress_msvcrt_asserts� s( ���� �r� c @ s( e Zd ZdZdZdZdd� Zdd� ZdS )r: z�Try to prevent a crash report from popping up. On Windows, don't display the Windows Error Reporting dialog. On UNIX, disable the creation of coredump file. Nc C s� t j�d�rOzddl}W n ty Y dS w |�� | _|�| j|jB � t |d�rMi | _ |j |j |j fD ]}|�||j�}|�||j�}||f| j |< q5| S z ddl}|| _W n tyd d| _Y nw | jdur�z| j�| jj�| _| j�| jjd| jd f� W n ttfy� Y nw t jdkr�ddl}g d�}|j||j|jd�}|� |�� d } W d � n1 s�w Y | � � d kr�t d d d d � | S )z�On Windows, disable Windows Error Reporting dialogs using SetErrorMode() and CrtSetReportMode(). On UNIX, try to save the previous core file size limit, then set soft limit to 0. r� r Nr� r r� )z/usr/bin/defaultsrW zcom.apple.CrashReporter� DialogType)r~ rg s developerz:this test triggers the Crash Reporter, that is intentionalr� T)�endr� ) r r� r� r� r � GetErrorMode� old_valuer� r� r� � old_modesr� r� r� r� r� r� r� r� � getrlimit� RLIMIT_CORE� setrlimitr� r� r� r� rx ry �stripr� ) r[ r� � report_type�old_mode�old_filer� r� r~ �procr~ rP rP rQ ro sh � ���#� � �� � � �z SuppressCrashReport.__enter__c G s� | j du rdS tj�d�r6ddl}|�| j � | jr2| j�� D ]\}\}}|�||� |� ||� q dS dS | j durUz | j � | j j | j � W dS t tfyT Y dS w dS )zARestore Windows ErrorMode or core file behavior to initial value.Nr� r )r� r r� r� r� r� r� r( r� r� r� r� r� r� r� )r[ � ignore_excr� r� r� r� rP rP rQ rv ] s$ � ��z SuppressCrashReport.__exit__)rL rM rN rO r� r� ro rv rP rP rP rQ r: s Br: c sp t ��� d� z�j� �W n ttfy t ��d��Y nw d� � ���fdd�}| �|� t��|� dS )z�Override 'object_to_patch'.'attr_name' with 'new_value'. Also, add a cleanup procedure to 'test_instance' to restore 'object_to_patch' value for 'attr_name'. The 'attr_name' should be a valid attribute for 'object_to_patch'. FNTc s" � r t ���� d S t��� d S rU )r_ r: rP �� attr_is_local� attr_name�object_to_patchr� rP rQ �cleanup� s zpatch.<locals>.cleanup)rw �__dict__rx �KeyError� addCleanupr_ )� test_instancer� r� � new_valuer� rP r� rQ �patchr s � r� c c s6 � z| dd� }dV W || dd�< dS || dd�< w )z-Like unittest.mock.patch.dict, but for lists.NrP )�orig�savedrP rP rQ � patch_list� s � r� c C sD zddl }W n ty Y n w |�� rt�d��ddl}|�| �S )zi Run code in a subinterpreter. Raise unittest.SkipTest if the tracemalloc module is enabled. r NzUrun_in_subinterp() cannot be used if tracemalloc module is tracing memory allocations)� tracemallocr � is_tracingrf ry � _testcapi�run_in_subinterp)�coder� r� rP rP rQ r� � s � r� c sH G � �fdd�d|�}d� |||� ��| � tt�� t� | �� � d S )Nc s e Zd Z� �fdd�ZdS )z%check_free_after_iterating.<locals>.Ac s( d� zt �� W d S ty Y d S w r )�next� StopIterationr^ ��done�itrP rQ �__del__� s �z-check_free_after_iterating.<locals>.A.__del__N)rL rM rN r� rP r� rP rQ �A� s r� F)� assertRaisesr� r� rn � assertTrue)r� �iterr* r� r� rP r� rQ �check_free_after_iterating� s r� c C s� ddl m}m}m}m} |�� }|�|� |jdkr,z|�� W n |j y+ Y dS w |j D ]-}| r8|| vr8q/t ||�}| rJ|dusIJ d| ��n|sMq/|� |d �du r\|d S q/dS )a< Check if the compiler components used to build the interpreter exist. Check for the existence of the compiler executables whose names are listed in 'cmd_names' or all the compiler executables when 'cmd_names' is empty and return the first missing executable or None when none is found missing. r )� ccompilerr� �spawnrW �msvcNz%the '%s' executable is not configured) � distutilsr� r� r� rW � new_compiler�customize_compiler� compiler_type� initialize�DistutilsPlatformError� executablesrw �find_executable)� cmd_namesr� r� r� rW �compilerr{ r~ rP rP rQ r> � s. � � ��r> c C sH d}t r | |k r td u rdd l}|�ddg��� dkatr |} t�| �S )Ng�h㈵��>r �getpropzro.kernel.qemu� 1)r. �_is_android_emulatorr� � check_outputr� r r1 )�interval�minimum_intervalr� rP rP rQ r1 � s �� r1 c c s^ � dd l } tj�� }| �� }z| �� d V W |r"| j|dd� d S d S |r.| j|dd� w w )Nr T)rD � all_threads)� faulthandlerr r3 �fileno� is_enabledrp rq )r� �fdr� rP rP rQ �disable_faulthandler� s � ��r� c @ r� ) � SaveSignalsz� Save and restore signal handlers. This class is only able to save/restore signal handlers registered by the Python signal module: see bpo-13285 for "external" signal handlers. c C sZ dd l }|| _ |�� | _dD ]}zt||�}W n ty Y qw | j�|� qi | _d S )Nr )�SIGKILL�SIGSTOP)�signal� valid_signals�signalsrw rx rp �handlers)r[ r� �signame�signumrP rP rQ rZ s � zSaveSignals.__init__c C s0 | j D ]}| j�|�}|d u rq|| j|< qd S rU )r� r� � getsignalr� �r[ r� �handlerrP rP rQ �save s �zSaveSignals.savec C s& | j �� D ] \}}| j�||� qd S rU )r� r( r� r� rP rP rQ �restore) s �zSaveSignals.restoreN)rL rM rN rO rZ r� r� rP rP rP rQ r� s r� c C s dd l } | jS r )r� � WITH_PYMALLOC)r� rP rP rQ � with_pymalloc. s r� c @ rF )� _ALWAYS_EQz+ Object that is equal to anything. c C r+ r rP �r[ �otherrP rP rQ �__eq__7 r� z_ALWAYS_EQ.__eq__c C r+ �NFrP r� rP rP rQ �__ne__9 r� z_ALWAYS_EQ.__ne__N)rL rM rN rO r� r rP rP rP rQ r� 3 s r� c @ r� ) � _NEVER_EQz/ Object that is not equal to anything. c C r+ r� rP r� rP rP rQ r� B r� z_NEVER_EQ.__eq__c C r+ r rP r� rP rP rQ r D r� z_NEVER_EQ.__ne__c C r+ )Nr rP r^ rP rP rQ �__hash__F r� z_NEVER_EQ.__hash__N)rL rM rN rO r� r r rP rP rP rQ r > s r c @ rF )�_LARGESTz? Object that is greater than anything (except itself). c C � t |t�S rU )r� r r� rP rP rQ r� P r� z_LARGEST.__eq__c C r+ r� rP r� rP rP rQ �__lt__R r� z_LARGEST.__lt__N)rL rM rN rO r� r rP rP rP rQ r K � r c @ rF )� _SMALLESTz< Object that is less than anything (except itself). c C r rU )r� r r� rP rP rQ r� \ r� z_SMALLEST.__eq__c C r+ r� rP r� rP rP rQ �__gt__^ r� z_SMALLEST.__gt__N)rL rM rN rO r� r rP rP rP rQ r W r r c C s ddl } | jjS )zDReturn the global event loop policy if one is set, else return None.r N)�asyncio.events�events�_event_loop_policy)�asynciorP rP rQ �maybe_get_event_loop_policyc s r )� �@ c C s� | |}}dd l }|�� �K}|�� d }t|d�|_|�|�}|d | | }|| } || } || } ||d |d | | | d| } t| �t| �� �fW d � S 1 s[w Y d S )Nr r� � r )�decimal� localcontext� bit_length�max�prec�Decimalr� �sqrt) �nbins�nballsr~ r� r �ctx�bitsr! �p1empty� meanempty�occupied� collisions�varrP rP rQ �collision_statsp s ($�r! c @ s0 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd S ) �catch_unraisable_exceptiona� Context manager catching unraisable exception using sys.unraisablehook. Storing the exception value (cm.unraisable.exc_value) creates a reference cycle. The reference cycle is broken explicitly when the context manager exits. Storing the object (cm.unraisable.object) can resurrect it if it is set to an object which is being finalized. Exiting the context manager clears the stored object. Usage: with support.catch_unraisable_exception() as cm: # code creating an "unraisable exception" ... # check the unraisable exception: use cm.unraisable ... # cm.unraisable attribute no longer exists at this point # (to break a reference cycle) c C s d | _ d | _d S rU )� unraisable� _old_hookr^ rP rP rQ rZ � s z#catch_unraisable_exception.__init__c C s || _ d S rU )r# )r[ r# rP rP rQ �_hook� s z catch_unraisable_exception._hookc C s t j| _| jt _| S rU )r �unraisablehookr$ r% r^ rP rP rQ ro � r� z$catch_unraisable_exception.__enter__c G s | j t_| `d S rU )r$ r r& r# )r[ �exc_inforP rP rQ rv � s z#catch_unraisable_exception.__exit__N)rL rM rN rO rZ r% ro rv rP rP rP rQ r" � s r" rE c C s$ t jdkrcddl}|du rt}t�� }d}d} t �| t j�\}}|dkr&n<t�� | } | |krUzt �| |j � t �| d� W n t yH Y nw t d| � d| d �d ���t |d |�}t� |� qnt �| d�\}}t �|�} | |kr�t d| � d | � d |� d���|| kr�t d|� d| � ���dS )a� Wait until process pid completes and check that the process exit code is exitcode. Raise an AssertionError if the process exit code is not equal to exitcode. If the process runs longer than timeout seconds (LONG_TIMEOUT by default), kill the process (if signal.SIGKILL is available) and raise an AssertionError. The timeout feature is not available on Windows. �ntr Ng����MbP?ri Tzprocess z is still running after z.1fz secondsr� z exited with code z, but exit code z is expectedzpid z != pid )rl r{ r� rF rl � monotonicr6 r7 �killr� r� �AssertionError�minrm �waitstatus_to_exitcode) r� �exitcoderF r� �t0rm � max_sleep�pid2r9 �dt� exitcode2rP rP rQ � wait_process� sF � � � ��r4 c C sf ddl m} | d� | d�}tjdkr1z |jdd� W dS ty0 } zt�d|����d}~ww dS ) z� Skip tests if the multiprocessing.synchronize module is missing, if there is no available semaphore implementation, or if creating a lock raises an OSError (on Linux only). r )� import_module�_multiprocessingzmultiprocessing.synchronize�linuxN)r z broken multiprocessing SemLock: )� import_helperr5 r r� �Lockr� rf ry )r5 � synchronize�excrP rP rQ �*skip_if_broken_multiprocessing_synchronize� s ���r< �K c c s8 � t �� }zt �| � d V W t �|� d S t �|� w rU )r �getrecursionlimit�setrecursionlimit)� max_depth�original_depthrP rP rQ �infinite_recursion s � rB c O s\ |j }|j}|dkr|� d|� �}n|� }dt�|�� d�}| jt||g|�R i |�� dS )z� Check that given type cannot be instantiated using *args and **kwds. See bpo-43916: Add Py_TPFLAGS_DISALLOW_INSTANTIATION type flag. �builtinsr� zcannot create 'z ' instancesN)rM rL r� ri r/ � TypeError)r5 �tpr� r� �modr{ �qualnamerV rP rP rQ r* s r* r1 �like�returnc C s, t � }tjdt| |dt|�� d� d� |S )Nr � (?#support�))r� r1 rG )�objectr� �filterwarnings�DeprecationWarningr )r1 rH �tokenrP rP rQ �ignore_deprecations_from% s �rP �tokensc G s� | st d��g }tdd� | D ��}tjD ]-\}}}}}|dkr7|tu r7t|tj�r-|j}n|p0d}|� |�r7q|� |||||f� qtj|krT|tjd d �< t� � d S d S )Nz<Provide token or tokens returned by ignore_deprecations_fromc s s � | ] }d t |�� d�V qdS )rJ rK N)r )r# rO rP rP rQ r� 5 s � z-clear_ignored_deprecations.<locals>.<genexpr>r r� ) r� r� r� �filtersrN r� r� �Patternrk r� rS �_filters_mutated) rQ � new_filtersr� �actionrG r� r1 r, rV rP rP rQ �clear_ignored_deprecations0 s �rW c c s8 � t �� }zt �| � dV W t �|� dS t �|� w )z>Temporarily change the integer string conversion length limit.N)r �get_int_max_str_digits�set_int_max_str_digits)� max_digits�currentrP rP rQ �adjust_int_max_str_digitsD s � r\ c C s dd� t dd�D �dg S )z�Returns a list of C0 control characters as strings. C0 control characters defined as the byte range 0x00-0x1F, and 0x7F. c S s g | ]}t |��qS rP )�chr)r# �crP rP rQ r% S r& z)control_characters_c0.<locals>.<listcomp>r r �)�rangerP rP rP rQ �control_characters_c0O s ra rU )r )r )r )r )r� )T)NNr )NrP rP )F)rP )r= )�rO rL r � contextlibr� rl r� r� r r� rl r� rf r� � testresultr r� r r� rC r� r� rD rE rF r� r r rT r ry r r% r& r" r r r r� r� r r} r r r� r� r r r� r r r r+ r, r r � SOCK_MAX_SIZEr r� � __getformat__r� r# r$ r r r � requires_legacy_unicode_capir- r� r. r0 � TEST_HTTP_URLr= r� rm rn rV ro �TEST_SUPPORT_DIRr r� rO r r6 r; r r2 �contextmanagerrc r r r rn rs rx r� r� r� r� r� r� r� r� r4 r< r� r� r� �_4Gr� r� r9 r� r r r r� r� r! r� r� r/ r� r� r� r r r r r r r r r r, r� �MISSING_C_DOCSTRINGS�HAVE_DOCSTRINGS�requires_docstringsr r5 r8 r3 r7 r5 rB rE rL r8 rP r) rT r� r' r( r� r: r� r� r� r� r> r� r1 r� r� r� r� r? r r@ �total_orderingr rA r rB r � hash_info�width� NHASHBITSr! r" r4 r< rB r* r� rP rW r\ r� ra rP rP rP rQ �<module> s� �, M � � 7 # !0 ! � � �� "R � ;`" ' ",4 PK ! j[ϩ| | ) __pycache__/script_helper.cpython-310.pycnu �[��� o p̦i�, � @ s� d dl Z d dlZd dlZd dlZd dlZd dlZd dlZd dlZd dlm Z d dl m Z d dl m Z dadd� ZG dd� de �dd ��Zd d � Zd d � Zdd� Zdd� Zejejd�dd�Zdd� Zd$dd�Zd%dd�Zd&d d �Z d'd d!�Z d"d#� Z dS )(� N)�source_from_cache)�support)�make_legacy_pycc C sV t du r)dtjv r da dS z t�tjdddg� W n tjy& da Y t S w da t S )a Returns True if our sys.executable interpreter requires environment variables in order to be able to run at all. This is designed to be used with @unittest.skipIf() to annotate tests that need to use an assert_python*() function to launch an isolated mode (-I) or no environment mode (-E) sub-interpreter process. A normal build & test does not run into this situation but it can happen when trying to run the standard library test suite from an interpreter that doesn't have an obvious home with Python's current home finding logic. Setting PYTHONHOME is one way to get most of the testsuite to run in that situation. PYTHONPATH or PYTHONUSERSITE are other common environment variables that might impact whether or not the interpreter can start. N� PYTHONHOMET�-Ez-czimport sys; sys.exit(0)F)�$__cached_interp_requires_environment�os�environ� subprocess� check_call�sys� executable�CalledProcessError� r r �1/usr/lib/python3.10/test/support/script_helper.py� interpreter_requires_environment s ��r c @ s e Zd ZdZdd� ZdS )�_PythonRunResultz2Helper for reporting Python subprocess run resultsc C s� d}| j | j}}t|�|krd|| d� }t|�|kr'd|| d� }|�dd��� }|�dd��� }td| j|||f ��)z4Provide helpful details about failed subcommand runsi@ s (... truncated stdout ...)Ns (... truncated stderr ...)�ascii�replacezRProcess return code is %d command line: %r stdout: --- %s --- stderr: --- %s ---)�out�err�len�decode�rstrip�AssertionError�rc)�self�cmd_line�maxlenr r r r r �fail= s ��z_PythonRunResult.failN)�__name__� __module__� __qualname__�__doc__r r r r r r : s r )r r r c O sB t � }|�dd �}d|v r|�d�}n| o| }tjddg}|r'|�d� n |s0|s0|�d� |�dd �rEi }tjdkrDtjd |d < ntj�� }d |vrRd |d < |� |� |� | � t j |t j t j t j ||d �}|�" z|�� \}} W |�� t �� n |�� t �� w W d � n1 s�w Y |j} t| || �|fS ) N�__cwd� __isolated�-X� faulthandlerz-Ir � __cleanenv�win32� SYSTEMROOT�TERM� )�stdin�stdout�stderr�env�cwd)r �popr r �append�platformr r �copy�update�extendr �Popen�PIPE� communicate�kill�_cleanup� returncoder ) �args�env_vars� env_requiredr1 �isolatedr r0 �procr r r r r r �run_python_until_endZ sD � � � �rC c O s4 t |i |��\}}|jr| s|js| s|�|� |S �N)rC r r )�expected_successr> r? �resr r r r �_assert_python� s rG c O � t dg| �R i |��S )a| Assert that running the interpreter with `args` and optional environment variables `env_vars` succeeds (rc == 0) and return a (return code, stdout, stderr) tuple. If the __cleanenv keyword is set, env_vars is used as a fresh environment. Python is started in isolated mode (command line option -I), except if the __isolated keyword is set to False. T�rG �r> r? r r r �assert_python_ok� s rK c O rH )z� Assert that running the interpreter with `args` and optional environment variables `env_vars` fails (rc != 0) and return a (return code, stdout, stderr) tuple. See assert_python_ok() for more options. FrI rJ r r r �assert_python_failure� s rL )r. r/ c O sX t jg}t� s |�d� |�|� |�dttj��}d|d< t j |ft j | |d�|��S )z�Run a Python subprocess with the given arguments. kw is extra keyword args to pass to subprocess.Popen. Returns a Popen object. r r0 �vt100r+ )r- r. r/ ) r r r r3 r7 � setdefault�dictr r r r8 r9 )r. r/ r> �kwr r0 r r r � spawn_python� s ��rQ c C s2 | j �� | j�� }| j�� | �� t�� |S )z?Run the given Popen process until completion and return stdout.)r- �closer. �read�waitr r< )�p�datar r r � kill_python� s rW Fc C sh |}|s |t jd 7 }t j�| |�}t|ddd�� }|�|� W d � n1 s)w Y t�� |S )N�py�wzutf-8)�encoding)r �extsep�path�join�open�write� importlib�invalidate_caches)� script_dir�script_basename�source� omit_suffix�script_filename� script_name� script_filer r r � make_script� s �ri c C s� |t j d }t j�| |�}t�|d��9}|d u r@|�t j�}t|�dkr:|d dkr:t t |��}t j� |�}|}nt j� |�}|� ||� W d � n1 sPw Y |t j�||�fS )N�ziprY � ���� __pycache__) r r[ r\ r] �zipfile�ZipFile�split�sepr r r �basenamer_ ) �zip_dir� zip_basenamerg � name_in_zip� zip_filename�zip_name�zip_file�parts� legacy_pycr r r �make_zip_script� s �r{ r, c C s t �| � t| d|� d S )N�__init__)r �mkdirri )�pkg_dir� init_sourcer r r �make_pkg� s r� � c s> g }t | dd�}|�|� tj�|�} t | ||�} |�| � |r5tj|dd�}tj| dd�} |�|| f� � fdd�td|d �D �} tj� | d tj�| ��} |tj d } tj� | | �}t � |d �� }| D ]}tj� || �}|� ||� qg|� | | � W d � n1 s�w Y |D ]}t�|� q�|tj� || �fS ) Nr| r, T)�doraisec s g | ] }t j�� g| ��qS r )r rq r] )�.0�i��pkg_namer r � <listcomp> s z make_zip_pkg.<locals>.<listcomp>r� ���rj rY )ri r3 r r\ rr � py_compile�compiler7 �ranger] r[ rn ro r_ �unlink)rs rt r� rc rd �depth�compiledr� � init_name� init_basenamerg � pkg_names�script_name_in_ziprv rw rx �name�init_name_in_zipr r� r � make_zip_pkg� s. � r� c C s� t jrDdd� }dtj�| �� �}t� t||�dd� tjdddd | d g}t� |�}t||� d |j � ��dd� |j rBt |� d ���d S t d | d � d S ) Nc S s d| � d�S )Nz===== z ======r )�textr r r �title s z run_test_script.<locals>.titlezscript T)�flushr r& r' z-uz-vz completed: exit code z failed) r �verboser r\ rr �printr r r �runr= r rK )�scriptr� r� r> rB r r r �run_test_script s ��r� )FrD )r, )r� F) � collectionsr` r r �os.pathr r� rn �importlib.utilr �testr �test.support.import_helperr r r � namedtupler rC rG rK rL r9 �STDOUTrQ rW ri r{ r� r� r� r r r r �<module> s8 $� 4 � PK ! �� � ( __pycache__/interpreters.cpython-310.pycnu �[��� o p̦i� � @ s� d Z ddlZddlZddlmZmZmZmZ g d�Zdd�dd�Z d d � Z d d � Z d d� Z G dd� d�Z dd� Zdd� ZG dd� d�Ze� ZG dd� de�ZG dd� de�ZdS )z"Subinterpreters High Level Module.� N)� ChannelError�ChannelNotFoundError�ChannelEmptyError� is_shareable) � Interpreter� get_current�get_main�create�list_all� SendChannel� RecvChannel�create_channel�list_all_channelsr r r r T��isolatedc C s t j| d�}t|| d�S )z'Return a new (idle) Python interpreter.r )� _interpretersr r )r �id� r �0/usr/lib/python3.10/test/support/interpreters.pyr s r c C � dd� t �� D �S )z!Return all existing interpreters.c S s g | ]}t |��qS r )r )�.0r r r r � <listcomp> s z list_all.<locals>.<listcomp>)r r r r r r r s r c C � t �� } t| �S )z)Return the currently running interpreter.)r r r �r r r r r ! � r c C r )z Return the main interpreter.)r r r r r r r r ' r r c @ sl e Zd ZdZdd�dd�Zdd� Zdd � Zd d � Zed d � �Z edd� �Z dd� Z dd� Z dd�dd�Z dS )r z A single Python interpreter.Nr c C s. t |ttjf�std|����|| _|| _d S �Nzid must be an int, got )� isinstance�intr � InterpreterID� TypeError�_id� _isolated)�selfr r r r r �__init__0 s zInterpreter.__init__c C sB t t| j�| jd�}dd� |�� D �}t| �j� dd�|�� d�S )N)r r c s s" � | ] \}}|� d |��V qdS )�=Nr )r �k�vr r r � <genexpr>8 s � z'Interpreter.__repr__.<locals>.<genexpr>�(z, �))�dictr r r! �items�type�__name__�join)r" �data�kwargsr r r �__repr__6 s zInterpreter.__repr__c C � t | j�S �N��hashr �r" r r r �__hash__; � zInterpreter.__hash__c C s t |t�stS |j| jkS r3 )r r �NotImplementedr �r" �otherr r r �__eq__> s zInterpreter.__eq__c C � | j S r3 �r r6 r r r r D � zInterpreter.idc C s | j d u r t�| j�| _ | j S r3 )r! r � is_isolatedr r6 r r r r H s zInterpreter.isolatedc C � t �| j�S )z<Return whether or not the identified interpreter is running.)r � is_runningr r6 r r r rB P s zInterpreter.is_runningc C rA )z�Finalize and destroy the interpreter. Attempting to destroy the current interpreter results in a RuntimeError. )r �destroyr r6 r r r �closeT s zInterpreter.close)�channelsc C s t �| j||� dS )zqRun the given source code in the interpreter. This blocks the current Python thread until done. N)r � run_stringr )r" �src_strrE r r r �run\ s zInterpreter.run)r- � __module__� __qualname__�__doc__r# r1 r7 r< �propertyr r rB rD rH r r r r r - s r c C s" t �� } t| �t| �}}||fS )z�Return (recv, send) for a new cross-interpreter channel. The channel may be used to pass data safely between interpreters. )r �channel_creater r )�cid�recv�sendr r r r d s r c C r )z4Return a list of (recv, send) for all open channels.c S s g | ] }t |�t|�f�qS r )r r )r rN r r r r p s �z%list_all_channels.<locals>.<listcomp>)r �channel_list_allr r r r r n s �r c @ s< e Zd ZdZdd� Zdd� Zdd� Zdd � Zed d � �Z d S ) � _ChannelEndz/The base class for RecvChannel and SendChannel.c C s( t |ttjf�std|����|| _d S r )r r r � ChannelIDr r )r" r r r r r# w s z_ChannelEnd.__init__c C s t | �j� dt| j�� d�S )Nz(id=r) )r, r- r r r6 r r r r1 | s z_ChannelEnd.__repr__c C r2 r3 r4 r6 r r r r7 r8 z_ChannelEnd.__hash__c C s4 t | t�r t |t�s tS nt |t�stS |j| jkS r3 )r r r9 r r r: r r r r< � s � z_ChannelEnd.__eq__c C r= r3 r> r6 r r r r � r? z_ChannelEnd.idN) r- rI rJ rK r# r1 r7 r< rL r r r r r rR t s rR c @ s. e Zd ZdZe� dd�dd�Zefdd�ZdS ) r z1The receiving end of a cross-interpreter channel.g{�G�z�?)� _sentinel�_delayc C s: t �| j|�}||u rt�|� t �| j|�}||u s |S )z�Return the next object from the channel. This blocks until an object has been sent, if none have been sent already. )r � channel_recvr �time�sleep)r" rT rU �objr r r rO � s �zRecvChannel.recvc C s" |t u r t�| j�S t�| j|�S )z�Return the next object from the channel. If none have been sent then return the default if one is provided or fail with ChannelEmptyError. Otherwise this is the same as recv(). )�_NOT_SETr rV r )r" �defaultr r r � recv_nowait� s zRecvChannel.recv_nowaitN)r- rI rJ rK �objectrO rZ r\ r r r r r � s r c @ s e Zd ZdZdd� Zdd� ZdS )r z/The sending end of a cross-interpreter channel.c C s t �| j|� t�d� dS )z{Send the object (i.e. its data) to the channel's receiving end. This blocks until the object is received. � N)r � channel_sendr rW rX �r" rY r r r rP � s zSendChannel.sendc C s t �| j|�S )z�Send the object to the channel's receiving end. If the object is immediately received then return True (else False). Otherwise this is the same as send(). )r r_ r r` r r r � send_nowait� s zSendChannel.send_nowaitN)r- rI rJ rK rP ra r r r r r � s r )rK rW �_xxsubinterpretersr r r r r �__all__r r r r r r r rR r] rZ r r r r r r �<module> s 7 PK ! �u�(� � + __pycache__/warnings_helper.cpython-310.pycnu �[��� o p̦i� � @ s� d dl Z d dlZd dlZd dlZd dlZdddd�dd�Zdd� ZG d d � d e�Ze j d d � �Z e j de d fdd��Z e j dd� �Z ddd�Ze j dd� �Zdd� ZdS )� N� � ��lineno�offsetc C s ddl m} tjdd��}t�dt� t|dd� W d � n1 s#w Y | �t|�d|� |\}| � t |j t�|j � |rJ| � t |j�|� | �|jd� | �|j� |d urb| �|j|� tjdd��}t�d t� || ||||d � W d � n1 s�w Y | �|g � d S ) Nr )�check_syntax_errorT��record�alwaysz <testcase>�execr �errorr )� test.supportr �warnings�catch_warnings� simplefilter� SyntaxWarning�compile� assertEqual�len� assertTrue� issubclass�category� assertRegex�str�message�filename�assertIsNotNoner )�testcase� statement�errtextr r r �warns�warn� r" �3/usr/lib/python3.10/test/support/warnings_helper.py�check_syntax_warning s. �� � �r$ c s � fdd�}|S )z�Decorator to suppress warnings. Use of context managers to hide warnings make diffs more noisy and tools like 'git blame' less useful. c s t �� ��� fdd��}|S )Nc sP t �� � t jd� d� �| g|�R i |��W d � S 1 s!w Y d S )N�ignore�r )r r r )�self�args�kwargs)r �testr" r# �wrapper- s $�z3ignore_warnings.<locals>.decorator.<locals>.wrapper)� functools�wraps)r* r+ r& )r* r# � decorator, s z"ignore_warnings.<locals>.decoratorr" )r r. r" r& r# �ignore_warnings& s r/ c @ s4 e Zd ZdZdd� Zdd� Zedd� �Zdd � Zd S ) �WarningsRecorderzyConvenience wrapper for the warnings list returned on entry to the warnings.catch_warnings() context manager. c C s || _ d| _d S )Nr �� _warnings�_last)r' � warnings_listr" r" r# �__init__: s zWarningsRecorder.__init__c C s@ t | j�| jkrt| jd |�S |tjjv rd S td| |f ��)N���z%r has no attribute %r)r r2 r3 �getattrr �WarningMessage�_WARNING_DETAILS�AttributeError)r' �attrr" r" r# � __getattr__> s z WarningsRecorder.__getattr__c C s | j | jd � S �Nr1 �r' r" r" r# r E s zWarningsRecorder.warningsc C s t | j�| _d S r= )r r2 r3 r> r" r" r# �resetI s zWarningsRecorder.resetN) �__name__� __module__� __qualname__�__doc__r5 r< �propertyr r? r" r" r" r# r0 6 s r0 c O s. |� d�}| sdtff} |du rd}t| |�S )a� Context manager to silence warnings. Accept 2-tuples as positional arguments: ("message regexp", WarningCategory) Optional argument: - if 'quiet' is True, it does not fail if a filter catches nothing (default True without argument, default False if some filters are defined) Without argument, it defaults to: check_warnings(("", Warning), quiet=True) �quietr NT)�get�Warning�_filterwarnings)�filtersr) rE r" r" r# �check_warningsM s rJ Fc c sj � ddl m} tjdd��}tjd||d� dV |r |� W d � n1 s(w Y | �|g � dS )a� Context manager to check that no warnings are emitted. This context manager enables a given warning within its scope and checks that no warnings are emitted even with that warning enabled. If force_gc is True, a garbage collection is attempted before checking for warnings. This may help to catch warnings emitted when objects are deleted, such as ResourceWarning. Other keyword arguments are passed to warnings.filterwarnings(). r )� gc_collectTr r )r r N)r rK r r �filterwarningsr )r r r �force_gcrK r r" r" r# �check_no_warningse s � �� �rN c c s< � t | tdd�� dV W d � dS 1 sw Y dS )a" Context manager to check that no ResourceWarning is emitted. Usage: with check_no_resource_warning(self): f = open(...) ... del f You must remove the object which may emit ResourceWarning before the end of the context manager. T)r rM N)rN �ResourceWarning)r r" r" r# �check_no_resource_warning~ s �"�rP c c s � t �d�}|j�d�}|r|�� tjdd��}t jd �d� t |�V W d � n1 s0w Y t |�}g }| D ]5\}}d} |dd� D ] }|j } t � |t| �t j�ret| j|�red} |�|� qI| sr|sr|�||jf� q=|r}td |d ��|r�td |d ��dS ) z�Catch the warnings, then check if all the expected warnings have been raised and re-raise unexpected warnings. If 'quiet' is True, only re-raise the unexpected warnings. � �__warningregistry__Tr r r NFzunhandled warning %sr z)filter (%r, %s) did not catch any warning)�sys� _getframe� f_globalsrF �clearr r �modulesr r0 �listr �re�matchr �Ir � __class__�remove�appendr@ �AssertionError) rI rE �frame�registry�w�reraise�missing�msg�cat�seen�warningr" r" r# rH � s> � � � ����rH c c s< � t jd d � } z d V W | t jd d �< d S | t jd d �< w r= )r rI )� old_filtersr" r" r# � save_restore_warnings_filters� s �"rj c C s t jdtdd� d S )Nz�This is used in test_support test to ensure support.ignore_deprecations_from() works as expected. You should not be seeing this.r )� stacklevel)r r! �DeprecationWarningr" r" r" r# �_warn_about_deprecation� s �rm )r )F)� contextlibr, rY rS r r$ r/ �objectr0 �contextmanagerrJ rG rN rP rH rj rm r" r" r" r# �<module> s( � ' PK ! ;^��� � + __pycache__/bytecode_helper.cpython-310.pycnu �[��� o p̦io � @ s8 d Z ddlZddlZddlZe� ZG dd� dej�ZdS )zGbytecode_helper - support tools for testing correct bytecode generation� Nc @ s0 e Zd ZdZdd� Zefdd�Zefdd�ZdS ) �BytecodeTestCasez1Custom assertion methods for inspecting bytecode.c C s t �� }tj||d� |�� S )N)�file)�io�StringIO�dis�getvalue)�self�co�s� r �3/usr/lib/python3.10/test/support/bytecode_helper.py�get_disassembly_as_string s z*BytecodeTestCase.get_disassembly_as_stringc C st t �|�D ]}|j|kr|tu s|j|kr| S q| �|�}|tu r*d||f }n d}||||f }| �|� dS )zAReturns instr if opname is found, otherwise throws AssertionErrorz %s not found in bytecode: %sz!(%s,%r) not found in bytecode: %sN)r �get_instructions�opname� _UNSPECIFIED�argvalr �fail�r �xr r �instr� disassembly�msgr r r �assertInBytecode s � z!BytecodeTestCase.assertInBytecodec C sn t �|�D ]/}|j|kr4| �|�}|tu r!d||f }| �|� q|j|kr4d}||||f }| �|� qdS )z(Throws AssertionError if opname is foundz%s occurs in bytecode: %sz (%s,%r) occurs in bytecode: %sN)r r r r r r r r r r r �assertNotInBytecode s ��z$BytecodeTestCase.assertNotInBytecodeN)�__name__� __module__� __qualname__�__doc__r r r r r r r r r s r )r �unittestr r �objectr �TestCaser r r r r �<module> s PK ! ���jj j * __pycache__/hashlib_helper.cpython-310.pycnu �[��� o p̦is � @ sJ d dl Z d dlZd dlZzd dlZW n ey dZY nw ddd�ZdS )� NTc s � ���fdd�� � S )a� Decorator raising SkipTest if a hashing algorithm is not available The hashing algorithm could be missing or blocked by a strict crypto policy. If 'openssl' is True, then the decorator checks that OpenSSL provides the algorithm. Otherwise the check falls back to built-in implementations. The usedforsecurity flag is passed to the constructor. ValueError: [digital envelope routines: EVP_DigestInit_ex] disabled for FIPS ValueError: unsupported hash type md4 c s| t � t�r.� j�d�}|d u r � fdd�}� jd |_� j|_n|j}t�|��}|� _� S t � � ��� ��fdd��}|S )N� setUpClassc s t � | ��� d S )N)�superr )�cls�� func_or_class� �2/usr/lib/python3.10/test/support/hashlib_helper.pyr s z:requires_hashdigest.<locals>.decorator.<locals>.setUpClassz .setUpClassc s^ z�rt d urt j� �d� ntj� �d� W n ty' t�d� � d���w �| i |��S )N)�usedforsecurityz hash digest 'z' is not available.)�_hashlib�new�hashlib� ValueError�unittest�SkipTest)�args�kwargs)� digestnamer �opensslr r r �wrapper& s � ��z7requires_hashdigest.<locals>.decorator.<locals>.wrapper) � isinstance�type�__dict__�get� __qualname__� __module__�__func__� classmethodr � functools�wraps)r r r �� decoratorr r r r r r s z&requires_hashdigest.<locals>.decoratorr )r r r r r r �requires_hashdigest s r! )NT)r r r r � ImportErrorr! r r r r �<module> s �PK ! 2 S� � * __pycache__/logging_helper.cpython-310.pycnu �[��� o p̦i� � @ s d dl ZG dd� dejj�ZdS )� Nc @ s, e Zd Zdd� Zdd� Zdd� Zdd� Zd S ) � TestHandlerc C s t jj�| d� || _d S )Nr )�logging�handlers�BufferingHandler�__init__�matcher)�selfr � r �2/usr/lib/python3.10/test/support/logging_helper.pyr s zTestHandler.__init__c C s dS )NFr )r r r r � shouldFlush s zTestHandler.shouldFlushc C s | � |� | j�|j� d S )N)�format�buffer�append�__dict__)r �recordr r r �emit s zTestHandler.emitc K s2 d}| j D ]}| jj|fi |��rd} |S q|S )zW Look for a saved dict whose keys/values match the supplied arguments. FT)r r �matches)r �kwargs�result�dr r r r s �zTestHandler.matchesN)�__name__� __module__� __qualname__r r r r r r r r r s r )�logging.handlersr r r r r r r r �<module> s PK ! q��s s hashlib_helper.pynu �[��� import functools import hashlib import unittest try: import _hashlib except ImportError: _hashlib = None def requires_hashdigest(digestname, openssl=None, usedforsecurity=True): """Decorator raising SkipTest if a hashing algorithm is not available The hashing algorithm could be missing or blocked by a strict crypto policy. If 'openssl' is True, then the decorator checks that OpenSSL provides the algorithm. Otherwise the check falls back to built-in implementations. The usedforsecurity flag is passed to the constructor. ValueError: [digital envelope routines: EVP_DigestInit_ex] disabled for FIPS ValueError: unsupported hash type md4 """ def decorator(func_or_class): if isinstance(func_or_class, type): setUpClass = func_or_class.__dict__.get('setUpClass') if setUpClass is None: def setUpClass(cls): super(func_or_class, cls).setUpClass() setUpClass.__qualname__ = func_or_class.__qualname__ + '.setUpClass' setUpClass.__module__ = func_or_class.__module__ else: setUpClass = setUpClass.__func__ setUpClass = classmethod(decorator(setUpClass)) func_or_class.setUpClass = setUpClass return func_or_class @functools.wraps(func_or_class) def wrapper(*args, **kwargs): try: if openssl and _hashlib is not None: _hashlib.new(digestname, usedforsecurity=usedforsecurity) else: hashlib.new(digestname, usedforsecurity=usedforsecurity) except ValueError: raise unittest.SkipTest( f"hash digest '{digestname}' is not available." ) return func_or_class(*args, **kwargs) return wrapper return decorator PK ! Q�o�� � __init__.pynu �[��� """Supporting definitions for the Python regression tests.""" if __name__ != 'test.support': raise ImportError('support must be imported from the test package') import contextlib import functools import os import re import stat import sys import sysconfig import time import types import unittest import warnings from .testresult import get_test_runner try: from _testcapi import unicode_legacy_string except ImportError: unicode_legacy_string = None __all__ = [ # globals "PIPE_MAX_SIZE", "verbose", "max_memuse", "use_resources", "failfast", # exceptions "Error", "TestFailed", "TestDidNotRun", "ResourceDenied", # io "record_original_stdout", "get_original_stdout", "captured_stdout", "captured_stdin", "captured_stderr", # unittest "is_resource_enabled", "requires", "requires_freebsd_version", "requires_linux_version", "requires_mac_ver", "check_syntax_error", "BasicTestRunner", "run_unittest", "run_doctest", "requires_gzip", "requires_bz2", "requires_lzma", "bigmemtest", "bigaddrspacetest", "cpython_only", "get_attribute", "requires_IEEE_754", "requires_zlib", "anticipate_failure", "load_package_tests", "detect_api_mismatch", "check__all__", "skip_if_buggy_ucrt_strfptime", "check_disallow_instantiation", "check_sanitizer", "skip_if_sanitizer", # sys "is_jython", "is_android", "check_impl_detail", "unix_shell", "setswitchinterval", # network "open_urlresource", # processes "reap_children", # miscellaneous "run_with_locale", "swap_item", "findfile", "swap_attr", "Matcher", "set_memlimit", "SuppressCrashReport", "sortdict", "run_with_tz", "PGO", "missing_compiler_executable", "ALWAYS_EQ", "NEVER_EQ", "LARGEST", "SMALLEST", "LOOPBACK_TIMEOUT", "INTERNET_TIMEOUT", "SHORT_TIMEOUT", "LONG_TIMEOUT", ] # Timeout in seconds for tests using a network server listening on the network # local loopback interface like 127.0.0.1. # # The timeout is long enough to prevent test failure: it takes into account # that the client and the server can run in different threads or even different # processes. # # The timeout should be long enough for connect(), recv() and send() methods # of socket.socket. LOOPBACK_TIMEOUT = 5.0 if sys.platform == 'win32' and ' 32 bit (ARM)' in sys.version: # bpo-37553: test_socket.SendfileUsingSendTest is taking longer than 2 # seconds on Windows ARM32 buildbot LOOPBACK_TIMEOUT = 10 elif sys.platform == 'vxworks': LOOPBACK_TIMEOUT = 10 # Timeout in seconds for network requests going to the internet. The timeout is # short enough to prevent a test to wait for too long if the internet request # is blocked for whatever reason. # # Usually, a timeout using INTERNET_TIMEOUT should not mark a test as failed, # but skip the test instead: see transient_internet(). INTERNET_TIMEOUT = 60.0 # Timeout in seconds to mark a test as failed if the test takes "too long". # # The timeout value depends on the regrtest --timeout command line option. # # If a test using SHORT_TIMEOUT starts to fail randomly on slow buildbots, use # LONG_TIMEOUT instead. SHORT_TIMEOUT = 30.0 # Timeout in seconds to detect when a test hangs. # # It is long enough to reduce the risk of test failure on the slowest Python # buildbots. It should not be used to mark a test as failed if the test takes # "too long". The timeout value depends on the regrtest --timeout command line # option. LONG_TIMEOUT = 5 * 60.0 class Error(Exception): """Base class for regression test exceptions.""" class TestFailed(Error): """Test failed.""" class TestFailedWithDetails(TestFailed): """Test failed.""" def __init__(self, msg, errors, failures): self.msg = msg self.errors = errors self.failures = failures super().__init__(msg, errors, failures) def __str__(self): return self.msg class TestDidNotRun(Error): """Test did not run any subtests.""" class ResourceDenied(unittest.SkipTest): """Test skipped because it requested a disallowed resource. This is raised when a test calls requires() for a resource that has not be enabled. It is used to distinguish between expected and unexpected skips. """ def anticipate_failure(condition): """Decorator to mark a test that is known to be broken in some cases Any use of this decorator should have a comment identifying the associated tracker issue. """ if condition: return unittest.expectedFailure return lambda f: f def load_package_tests(pkg_dir, loader, standard_tests, pattern): """Generic load_tests implementation for simple test packages. Most packages can implement load_tests using this function as follows: def load_tests(*args): return load_package_tests(os.path.dirname(__file__), *args) """ if pattern is None: pattern = "test*" top_dir = os.path.dirname( # Lib os.path.dirname( # test os.path.dirname(__file__))) # support package_tests = loader.discover(start_dir=pkg_dir, top_level_dir=top_dir, pattern=pattern) standard_tests.addTests(package_tests) return standard_tests def get_attribute(obj, name): """Get an attribute, raising SkipTest if AttributeError is raised.""" try: attribute = getattr(obj, name) except AttributeError: raise unittest.SkipTest("object %r has no attribute %r" % (obj, name)) else: return attribute verbose = 1 # Flag set to 0 by regrtest.py use_resources = None # Flag set to [] by regrtest.py max_memuse = 0 # Disable bigmem tests (they will still be run with # small sizes, to make sure they work.) real_max_memuse = 0 junit_xml_list = None # list of testsuite XML elements failfast = False # _original_stdout is meant to hold stdout at the time regrtest began. # This may be "the real" stdout, or IDLE's emulation of stdout, or whatever. # The point is to have some flavor of stdout the user can actually see. _original_stdout = None def record_original_stdout(stdout): global _original_stdout _original_stdout = stdout def get_original_stdout(): return _original_stdout or sys.stdout def _force_run(path, func, *args): try: return func(*args) except OSError as err: if verbose >= 2: print('%s: %s' % (err.__class__.__name__, err)) print('re-run %s%r' % (func.__name__, args)) os.chmod(path, stat.S_IRWXU) return func(*args) # Check whether a gui is actually available def _is_gui_available(): if hasattr(_is_gui_available, 'result'): return _is_gui_available.result import platform reason = None if sys.platform.startswith('win') and platform.win32_is_iot(): reason = "gui is not available on Windows IoT Core" elif sys.platform.startswith('win'): # if Python is running as a service (such as the buildbot service), # gui interaction may be disallowed import ctypes import ctypes.wintypes UOI_FLAGS = 1 WSF_VISIBLE = 0x0001 class USEROBJECTFLAGS(ctypes.Structure): _fields_ = [("fInherit", ctypes.wintypes.BOOL), ("fReserved", ctypes.wintypes.BOOL), ("dwFlags", ctypes.wintypes.DWORD)] dll = ctypes.windll.user32 h = dll.GetProcessWindowStation() if not h: raise ctypes.WinError() uof = USEROBJECTFLAGS() needed = ctypes.wintypes.DWORD() res = dll.GetUserObjectInformationW(h, UOI_FLAGS, ctypes.byref(uof), ctypes.sizeof(uof), ctypes.byref(needed)) if not res: raise ctypes.WinError() if not bool(uof.dwFlags & WSF_VISIBLE): reason = "gui not available (WSF_VISIBLE flag not set)" elif sys.platform == 'darwin': # The Aqua Tk implementations on OS X can abort the process if # being called in an environment where a window server connection # cannot be made, for instance when invoked by a buildbot or ssh # process not running under the same user id as the current console # user. To avoid that, raise an exception if the window manager # connection is not available. from ctypes import cdll, c_int, pointer, Structure from ctypes.util import find_library app_services = cdll.LoadLibrary(find_library("ApplicationServices")) if app_services.CGMainDisplayID() == 0: reason = "gui tests cannot run without OS X window manager" else: class ProcessSerialNumber(Structure): _fields_ = [("highLongOfPSN", c_int), ("lowLongOfPSN", c_int)] psn = ProcessSerialNumber() psn_p = pointer(psn) if ( (app_services.GetCurrentProcess(psn_p) < 0) or (app_services.SetFrontProcess(psn_p) < 0) ): reason = "cannot run without OS X gui process" # check on every platform whether tkinter can actually do anything if not reason: try: from tkinter import Tk root = Tk() root.withdraw() root.update() root.destroy() except Exception as e: err_string = str(e) if len(err_string) > 50: err_string = err_string[:50] + ' [...]' reason = 'Tk unavailable due to {}: {}'.format(type(e).__name__, err_string) _is_gui_available.reason = reason _is_gui_available.result = not reason return _is_gui_available.result def is_resource_enabled(resource): """Test whether a resource is enabled. Known resources are set by regrtest.py. If not running under regrtest.py, all resources are assumed enabled unless use_resources has been set. """ return use_resources is None or resource in use_resources def requires(resource, msg=None): """Raise ResourceDenied if the specified resource is not available.""" if not is_resource_enabled(resource): if msg is None: msg = "Use of the %r resource not enabled" % resource raise ResourceDenied(msg) if resource == 'gui' and not _is_gui_available(): raise ResourceDenied(_is_gui_available.reason) def _requires_unix_version(sysname, min_version): """Decorator raising SkipTest if the OS is `sysname` and the version is less than `min_version`. For example, @_requires_unix_version('FreeBSD', (7, 2)) raises SkipTest if the FreeBSD version is less than 7.2. """ import platform min_version_txt = '.'.join(map(str, min_version)) version_txt = platform.release().split('-', 1)[0] if platform.system() == sysname: try: version = tuple(map(int, version_txt.split('.'))) except ValueError: skip = False else: skip = version < min_version else: skip = False return unittest.skipIf( skip, f"{sysname} version {min_version_txt} or higher required, not " f"{version_txt}" ) def requires_freebsd_version(*min_version): """Decorator raising SkipTest if the OS is FreeBSD and the FreeBSD version is less than `min_version`. For example, @requires_freebsd_version(7, 2) raises SkipTest if the FreeBSD version is less than 7.2. """ return _requires_unix_version('FreeBSD', min_version) def requires_linux_version(*min_version): """Decorator raising SkipTest if the OS is Linux and the Linux version is less than `min_version`. For example, @requires_linux_version(2, 6, 32) raises SkipTest if the Linux version is less than 2.6.32. """ return _requires_unix_version('Linux', min_version) def requires_mac_ver(*min_version): """Decorator raising SkipTest if the OS is Mac OS X and the OS X version if less than min_version. For example, @requires_mac_ver(10, 5) raises SkipTest if the OS X version is lesser than 10.5. """ def decorator(func): @functools.wraps(func) def wrapper(*args, **kw): if sys.platform == 'darwin': import platform version_txt = platform.mac_ver()[0] try: version = tuple(map(int, version_txt.split('.'))) except ValueError: pass else: if version < min_version: min_version_txt = '.'.join(map(str, min_version)) raise unittest.SkipTest( "Mac OS X %s or higher required, not %s" % (min_version_txt, version_txt)) return func(*args, **kw) wrapper.min_version = min_version return wrapper return decorator def check_sanitizer(*, address=False, memory=False, ub=False): """Returns True if Python is compiled with sanitizer support""" if not (address or memory or ub): raise ValueError('At least one of address, memory, or ub must be True') _cflags = sysconfig.get_config_var('CFLAGS') or '' _config_args = sysconfig.get_config_var('CONFIG_ARGS') or '' memory_sanitizer = ( '-fsanitize=memory' in _cflags or '--with-memory-sanitizer' in _config_args ) address_sanitizer = ( '-fsanitize=address' in _cflags or '--with-memory-sanitizer' in _config_args ) ub_sanitizer = ( '-fsanitize=undefined' in _cflags or '--with-undefined-behavior-sanitizer' in _config_args ) return ( (memory and memory_sanitizer) or (address and address_sanitizer) or (ub and ub_sanitizer) ) def skip_if_sanitizer(reason=None, *, address=False, memory=False, ub=False): """Decorator raising SkipTest if running with a sanitizer active.""" if not reason: reason = 'not working with sanitizers active' skip = check_sanitizer(address=address, memory=memory, ub=ub) return unittest.skipIf(skip, reason) def system_must_validate_cert(f): """Skip the test on TLS certificate validation failures.""" @functools.wraps(f) def dec(*args, **kwargs): try: f(*args, **kwargs) except OSError as e: if "CERTIFICATE_VERIFY_FAILED" in str(e): raise unittest.SkipTest("system does not contain " "necessary certificates") raise return dec # A constant likely larger than the underlying OS pipe buffer size, to # make writes blocking. # Windows limit seems to be around 512 B, and many Unix kernels have a # 64 KiB pipe buffer size or 16 * PAGE_SIZE: take a few megs to be sure. # (see issue #17835 for a discussion of this number). PIPE_MAX_SIZE = 4 * 1024 * 1024 + 1 # A constant likely larger than the underlying OS socket buffer size, to make # writes blocking. # The socket buffer sizes can usually be tuned system-wide (e.g. through sysctl # on Linux), or on a per-socket basis (SO_SNDBUF/SO_RCVBUF). See issue #18643 # for a discussion of this number. SOCK_MAX_SIZE = 16 * 1024 * 1024 + 1 # decorator for skipping tests on non-IEEE 754 platforms requires_IEEE_754 = unittest.skipUnless( float.__getformat__("double").startswith("IEEE"), "test requires IEEE 754 doubles") def requires_zlib(reason='requires zlib'): try: import zlib except ImportError: zlib = None return unittest.skipUnless(zlib, reason) def requires_gzip(reason='requires gzip'): try: import gzip except ImportError: gzip = None return unittest.skipUnless(gzip, reason) def requires_bz2(reason='requires bz2'): try: import bz2 except ImportError: bz2 = None return unittest.skipUnless(bz2, reason) def requires_lzma(reason='requires lzma'): try: import lzma except ImportError: lzma = None return unittest.skipUnless(lzma, reason) requires_legacy_unicode_capi = unittest.skipUnless(unicode_legacy_string, 'requires legacy Unicode C API') is_jython = sys.platform.startswith('java') is_android = hasattr(sys, 'getandroidapilevel') if sys.platform not in ('win32', 'vxworks'): unix_shell = '/system/bin/sh' if is_android else '/bin/sh' else: unix_shell = None # Define the URL of a dedicated HTTP server for the network tests. # The URL must use clear-text HTTP: no redirection to encrypted HTTPS. TEST_HTTP_URL = "http://www.pythontest.net" # Set by libregrtest/main.py so we can skip tests that are not # useful for PGO PGO = False # Set by libregrtest/main.py if we are running the extended (time consuming) # PGO task. If this is True, PGO is also True. PGO_EXTENDED = False # TEST_HOME_DIR refers to the top level directory of the "test" package # that contains Python's regression test suite TEST_SUPPORT_DIR = os.path.dirname(os.path.abspath(__file__)) TEST_HOME_DIR = os.path.dirname(TEST_SUPPORT_DIR) # TEST_DATA_DIR is used as a target download location for remote resources TEST_DATA_DIR = os.path.join(TEST_HOME_DIR, "data") def darwin_malloc_err_warning(test_name): """Assure user that loud errors generated by macOS libc's malloc are expected.""" if sys.platform != 'darwin': return import shutil msg = ' NOTICE ' detail = (f'{test_name} may generate "malloc can\'t allocate region"\n' 'warnings on macOS systems. This behavior is known. Do not\n' 'report a bug unless tests are also failing. See bpo-40928.') padding, _ = shutil.get_terminal_size() print(msg.center(padding, '-')) print(detail) print('-' * padding) def findfile(filename, subdir=None): """Try to find a file on sys.path or in the test directory. If it is not found the argument passed to the function is returned (this does not necessarily signal failure; could still be the legitimate path). Setting *subdir* indicates a relative path to use to find the file rather than looking directly in the path directories. """ if os.path.isabs(filename): return filename if subdir is not None: filename = os.path.join(subdir, filename) path = [TEST_HOME_DIR] + sys.path for dn in path: fn = os.path.join(dn, filename) if os.path.exists(fn): return fn return filename def sortdict(dict): "Like repr(dict), but in sorted order." items = sorted(dict.items()) reprpairs = ["%r: %r" % pair for pair in items] withcommas = ", ".join(reprpairs) return "{%s}" % withcommas def check_syntax_error(testcase, statement, errtext='', *, lineno=None, offset=None): with testcase.assertRaisesRegex(SyntaxError, errtext) as cm: compile(statement, '<test string>', 'exec') err = cm.exception testcase.assertIsNotNone(err.lineno) if lineno is not None: testcase.assertEqual(err.lineno, lineno) testcase.assertIsNotNone(err.offset) if offset is not None: testcase.assertEqual(err.offset, offset) def open_urlresource(url, *args, **kw): import urllib.request, urllib.parse from .os_helper import unlink try: import gzip except ImportError: gzip = None check = kw.pop('check', None) filename = urllib.parse.urlparse(url)[2].split('/')[-1] # '/': it's URL! fn = os.path.join(TEST_DATA_DIR, filename) def check_valid_file(fn): f = open(fn, *args, **kw) if check is None: return f elif check(f): f.seek(0) return f f.close() if os.path.exists(fn): f = check_valid_file(fn) if f is not None: return f unlink(fn) # Verify the requirement before downloading the file requires('urlfetch') if verbose: print('\tfetching %s ...' % url, file=get_original_stdout()) opener = urllib.request.build_opener() if gzip: opener.addheaders.append(('Accept-Encoding', 'gzip')) f = opener.open(url, timeout=INTERNET_TIMEOUT) if gzip and f.headers.get('Content-Encoding') == 'gzip': f = gzip.GzipFile(fileobj=f) try: with open(fn, "wb") as out: s = f.read() while s: out.write(s) s = f.read() finally: f.close() f = check_valid_file(fn) if f is not None: return f raise TestFailed('invalid resource %r' % fn) @contextlib.contextmanager def captured_output(stream_name): """Return a context manager used by captured_stdout/stdin/stderr that temporarily replaces the sys stream *stream_name* with a StringIO.""" import io orig_stdout = getattr(sys, stream_name) setattr(sys, stream_name, io.StringIO()) try: yield getattr(sys, stream_name) finally: setattr(sys, stream_name, orig_stdout) def captured_stdout(): """Capture the output of sys.stdout: with captured_stdout() as stdout: print("hello") self.assertEqual(stdout.getvalue(), "hello\\n") """ return captured_output("stdout") def captured_stderr(): """Capture the output of sys.stderr: with captured_stderr() as stderr: print("hello", file=sys.stderr) self.assertEqual(stderr.getvalue(), "hello\\n") """ return captured_output("stderr") def captured_stdin(): """Capture the input to sys.stdin: with captured_stdin() as stdin: stdin.write('hello\\n') stdin.seek(0) # call test code that consumes from sys.stdin captured = input() self.assertEqual(captured, "hello") """ return captured_output("stdin") def gc_collect(): """Force as many objects as possible to be collected. In non-CPython implementations of Python, this is needed because timely deallocation is not guaranteed by the garbage collector. (Even in CPython this can be the case in case of reference cycles.) This means that __del__ methods may be called later than expected and weakrefs may remain alive for longer than expected. This function tries its best to force all garbage objects to disappear. """ import gc gc.collect() if is_jython: time.sleep(0.1) gc.collect() gc.collect() @contextlib.contextmanager def disable_gc(): import gc have_gc = gc.isenabled() gc.disable() try: yield finally: if have_gc: gc.enable() def python_is_optimized(): """Find if Python was built with optimizations.""" cflags = sysconfig.get_config_var('PY_CFLAGS') or '' final_opt = "" for opt in cflags.split(): if opt.startswith('-O'): final_opt = opt return final_opt not in ('', '-O0', '-Og') _header = 'nP' _align = '0n' if hasattr(sys, "getobjects"): _header = '2P' + _header _align = '0P' _vheader = _header + 'n' def calcobjsize(fmt): import struct return struct.calcsize(_header + fmt + _align) def calcvobjsize(fmt): import struct return struct.calcsize(_vheader + fmt + _align) _TPFLAGS_HAVE_GC = 1<<14 _TPFLAGS_HEAPTYPE = 1<<9 def check_sizeof(test, o, size): import _testinternalcapi result = sys.getsizeof(o) # add GC header size if ((type(o) == type) and (o.__flags__ & _TPFLAGS_HEAPTYPE) or\ ((type(o) != type) and (type(o).__flags__ & _TPFLAGS_HAVE_GC))): size += _testinternalcapi.SIZEOF_PYGC_HEAD msg = 'wrong size for %s: got %d, expected %d' \ % (type(o), result, size) test.assertEqual(result, size, msg) #======================================================================= # Decorator for running a function in a different locale, correctly resetting # it afterwards. @contextlib.contextmanager def run_with_locale(catstr, *locales): try: import locale category = getattr(locale, catstr) orig_locale = locale.setlocale(category) except AttributeError: # if the test author gives us an invalid category string raise except: # cannot retrieve original locale, so do nothing locale = orig_locale = None else: for loc in locales: try: locale.setlocale(category, loc) break except: pass try: yield finally: if locale and orig_locale: locale.setlocale(category, orig_locale) #======================================================================= # Decorator for running a function in a specific timezone, correctly # resetting it afterwards. def run_with_tz(tz): def decorator(func): def inner(*args, **kwds): try: tzset = time.tzset except AttributeError: raise unittest.SkipTest("tzset required") if 'TZ' in os.environ: orig_tz = os.environ['TZ'] else: orig_tz = None os.environ['TZ'] = tz tzset() # now run the function, resetting the tz on exceptions try: return func(*args, **kwds) finally: if orig_tz is None: del os.environ['TZ'] else: os.environ['TZ'] = orig_tz time.tzset() inner.__name__ = func.__name__ inner.__doc__ = func.__doc__ return inner return decorator #======================================================================= # Big-memory-test support. Separate from 'resources' because memory use # should be configurable. # Some handy shorthands. Note that these are used for byte-limits as well # as size-limits, in the various bigmem tests _1M = 1024*1024 _1G = 1024 * _1M _2G = 2 * _1G _4G = 4 * _1G MAX_Py_ssize_t = sys.maxsize def set_memlimit(limit): global max_memuse global real_max_memuse sizes = { 'k': 1024, 'm': _1M, 'g': _1G, 't': 1024*_1G, } m = re.match(r'(\d+(\.\d+)?) (K|M|G|T)b?$', limit, re.IGNORECASE | re.VERBOSE) if m is None: raise ValueError('Invalid memory limit %r' % (limit,)) memlimit = int(float(m.group(1)) * sizes[m.group(3).lower()]) real_max_memuse = memlimit if memlimit > MAX_Py_ssize_t: memlimit = MAX_Py_ssize_t if memlimit < _2G - 1: raise ValueError('Memory limit %r too low to be useful' % (limit,)) max_memuse = memlimit class _MemoryWatchdog: """An object which periodically watches the process' memory consumption and prints it out. """ def __init__(self): self.procfile = '/proc/{pid}/statm'.format(pid=os.getpid()) self.started = False def start(self): import warnings try: f = open(self.procfile, 'r') except OSError as e: warnings.warn('/proc not available for stats: {}'.format(e), RuntimeWarning) sys.stderr.flush() return import subprocess with f: watchdog_script = findfile("memory_watchdog.py") self.mem_watchdog = subprocess.Popen([sys.executable, watchdog_script], stdin=f, stderr=subprocess.DEVNULL) self.started = True def stop(self): if self.started: self.mem_watchdog.terminate() self.mem_watchdog.wait() def bigmemtest(size, memuse, dry_run=True): """Decorator for bigmem tests. 'size' is a requested size for the test (in arbitrary, test-interpreted units.) 'memuse' is the number of bytes per unit for the test, or a good estimate of it. For example, a test that needs two byte buffers, of 4 GiB each, could be decorated with @bigmemtest(size=_4G, memuse=2). The 'size' argument is normally passed to the decorated test method as an extra argument. If 'dry_run' is true, the value passed to the test method may be less than the requested value. If 'dry_run' is false, it means the test doesn't support dummy runs when -M is not specified. """ def decorator(f): def wrapper(self): size = wrapper.size memuse = wrapper.memuse if not real_max_memuse: maxsize = 5147 else: maxsize = size if ((real_max_memuse or not dry_run) and real_max_memuse < maxsize * memuse): raise unittest.SkipTest( "not enough memory: %.1fG minimum needed" % (size * memuse / (1024 ** 3))) if real_max_memuse and verbose: print() print(" ... expected peak memory use: {peak:.1f}G" .format(peak=size * memuse / (1024 ** 3))) watchdog = _MemoryWatchdog() watchdog.start() else: watchdog = None try: return f(self, maxsize) finally: if watchdog: watchdog.stop() wrapper.size = size wrapper.memuse = memuse return wrapper return decorator def bigaddrspacetest(f): """Decorator for tests that fill the address space.""" def wrapper(self): if max_memuse < MAX_Py_ssize_t: if MAX_Py_ssize_t >= 2**63 - 1 and max_memuse >= 2**31: raise unittest.SkipTest( "not enough memory: try a 32-bit build instead") else: raise unittest.SkipTest( "not enough memory: %.1fG minimum needed" % (MAX_Py_ssize_t / (1024 ** 3))) else: return f(self) return wrapper #======================================================================= # unittest integration. class BasicTestRunner: def run(self, test): result = unittest.TestResult() test(result) return result def _id(obj): return obj def requires_resource(resource): if resource == 'gui' and not _is_gui_available(): return unittest.skip(_is_gui_available.reason) if is_resource_enabled(resource): return _id else: return unittest.skip("resource {0!r} is not enabled".format(resource)) def cpython_only(test): """ Decorator for tests only applicable on CPython. """ return impl_detail(cpython=True)(test) def impl_detail(msg=None, **guards): if check_impl_detail(**guards): return _id if msg is None: guardnames, default = _parse_guards(guards) if default: msg = "implementation detail not available on {0}" else: msg = "implementation detail specific to {0}" guardnames = sorted(guardnames.keys()) msg = msg.format(' or '.join(guardnames)) return unittest.skip(msg) def _parse_guards(guards): # Returns a tuple ({platform_name: run_me}, default_value) if not guards: return ({'cpython': True}, False) is_true = list(guards.values())[0] assert list(guards.values()) == [is_true] * len(guards) # all True or all False return (guards, not is_true) # Use the following check to guard CPython's implementation-specific tests -- # or to run them only on the implementation(s) guarded by the arguments. def check_impl_detail(**guards): """This function returns True or False depending on the host platform. Examples: if check_impl_detail(): # only on CPython (default) if check_impl_detail(jython=True): # only on Jython if check_impl_detail(cpython=False): # everywhere except on CPython """ guards, default = _parse_guards(guards) return guards.get(sys.implementation.name, default) def no_tracing(func): """Decorator to temporarily turn off tracing for the duration of a test.""" if not hasattr(sys, 'gettrace'): return func else: @functools.wraps(func) def wrapper(*args, **kwargs): original_trace = sys.gettrace() try: sys.settrace(None) return func(*args, **kwargs) finally: sys.settrace(original_trace) return wrapper def refcount_test(test): """Decorator for tests which involve reference counting. To start, the decorator does not run the test if is not run by CPython. After that, any trace function is unset during the test to prevent unexpected refcounts caused by the trace function. """ return no_tracing(cpython_only(test)) def _filter_suite(suite, pred): """Recursively filter test cases in a suite based on a predicate.""" newtests = [] for test in suite._tests: if isinstance(test, unittest.TestSuite): _filter_suite(test, pred) newtests.append(test) else: if pred(test): newtests.append(test) suite._tests = newtests def _run_suite(suite): """Run tests from a unittest.TestSuite-derived class.""" runner = get_test_runner(sys.stdout, verbosity=verbose, capture_output=(junit_xml_list is not None)) result = runner.run(suite) if junit_xml_list is not None: junit_xml_list.append(result.get_xml_element()) if not result.testsRun and not result.skipped: raise TestDidNotRun if not result.wasSuccessful(): if len(result.errors) == 1 and not result.failures: err = result.errors[0][1] elif len(result.failures) == 1 and not result.errors: err = result.failures[0][1] else: err = "multiple errors occurred" if not verbose: err += "; run in verbose mode for details" errors = [(str(tc), exc_str) for tc, exc_str in result.errors] failures = [(str(tc), exc_str) for tc, exc_str in result.failures] raise TestFailedWithDetails(err, errors, failures) # By default, don't filter tests _match_test_func = None _accept_test_patterns = None _ignore_test_patterns = None def match_test(test): # Function used by support.run_unittest() and regrtest --list-cases if _match_test_func is None: return True else: return _match_test_func(test.id()) def _is_full_match_test(pattern): # If a pattern contains at least one dot, it's considered # as a full test identifier. # Example: 'test.test_os.FileTests.test_access'. # # ignore patterns which contain fnmatch patterns: '*', '?', '[...]' # or '[!...]'. For example, ignore 'test_access*'. return ('.' in pattern) and (not re.search(r'[?*\[\]]', pattern)) def set_match_tests(accept_patterns=None, ignore_patterns=None): global _match_test_func, _accept_test_patterns, _ignore_test_patterns if accept_patterns is None: accept_patterns = () if ignore_patterns is None: ignore_patterns = () accept_func = ignore_func = None if accept_patterns != _accept_test_patterns: accept_patterns, accept_func = _compile_match_function(accept_patterns) if ignore_patterns != _ignore_test_patterns: ignore_patterns, ignore_func = _compile_match_function(ignore_patterns) # Create a copy since patterns can be mutable and so modified later _accept_test_patterns = tuple(accept_patterns) _ignore_test_patterns = tuple(ignore_patterns) if accept_func is not None or ignore_func is not None: def match_function(test_id): accept = True ignore = False if accept_func: accept = accept_func(test_id) if ignore_func: ignore = ignore_func(test_id) return accept and not ignore _match_test_func = match_function def _compile_match_function(patterns): if not patterns: func = None # set_match_tests(None) behaves as set_match_tests(()) patterns = () elif all(map(_is_full_match_test, patterns)): # Simple case: all patterns are full test identifier. # The test.bisect_cmd utility only uses such full test identifiers. func = set(patterns).__contains__ else: import fnmatch regex = '|'.join(map(fnmatch.translate, patterns)) # The search *is* case sensitive on purpose: # don't use flags=re.IGNORECASE regex_match = re.compile(regex).match def match_test_regex(test_id): if regex_match(test_id): # The regex matches the whole identifier, for example # 'test.test_os.FileTests.test_access'. return True else: # Try to match parts of the test identifier. # For example, split 'test.test_os.FileTests.test_access' # into: 'test', 'test_os', 'FileTests' and 'test_access'. return any(map(regex_match, test_id.split("."))) func = match_test_regex return patterns, func def run_unittest(*classes): """Run tests from unittest.TestCase-derived classes.""" valid_types = (unittest.TestSuite, unittest.TestCase) suite = unittest.TestSuite() for cls in classes: if isinstance(cls, str): if cls in sys.modules: suite.addTest(unittest.findTestCases(sys.modules[cls])) else: raise ValueError("str arguments must be keys in sys.modules") elif isinstance(cls, valid_types): suite.addTest(cls) else: suite.addTest(unittest.makeSuite(cls)) _filter_suite(suite, match_test) _run_suite(suite) #======================================================================= # Check for the presence of docstrings. # Rather than trying to enumerate all the cases where docstrings may be # disabled, we just check for that directly def _check_docstrings(): """Just used to check if docstrings are enabled""" MISSING_C_DOCSTRINGS = (check_impl_detail() and sys.platform != 'win32' and not sysconfig.get_config_var('WITH_DOC_STRINGS')) HAVE_DOCSTRINGS = (_check_docstrings.__doc__ is not None and not MISSING_C_DOCSTRINGS) requires_docstrings = unittest.skipUnless(HAVE_DOCSTRINGS, "test requires docstrings") #======================================================================= # doctest driver. def run_doctest(module, verbosity=None, optionflags=0): """Run doctest on the given module. Return (#failures, #tests). If optional argument verbosity is not specified (or is None), pass support's belief about verbosity on to doctest. Else doctest's usual behavior is used (it searches sys.argv for -v). """ import doctest if verbosity is None: verbosity = verbose else: verbosity = None f, t = doctest.testmod(module, verbose=verbosity, optionflags=optionflags) if f: raise TestFailed("%d of %d doctests failed" % (f, t)) if verbose: print('doctest (%s) ... %d tests with zero failures' % (module.__name__, t)) return f, t #======================================================================= # Support for saving and restoring the imported modules. def print_warning(msg): # bpo-39983: Print into sys.__stderr__ to display the warning even # when sys.stderr is captured temporarily by a test for line in msg.splitlines(): print(f"Warning -- {line}", file=sys.__stderr__, flush=True) # Flag used by saved_test_environment of test.libregrtest.save_env, # to check if a test modified the environment. The flag should be set to False # before running a new test. # # For example, threading_helper.threading_cleanup() sets the flag is the function fails # to cleanup threads. environment_altered = False def reap_children(): """Use this function at the end of test_main() whenever sub-processes are started. This will help ensure that no extra children (zombies) stick around to hog resources and create problems when looking for refleaks. """ global environment_altered # Need os.waitpid(-1, os.WNOHANG): Windows is not supported if not (hasattr(os, 'waitpid') and hasattr(os, 'WNOHANG')): return # Reap all our dead child processes so we don't leave zombies around. # These hog resources and might be causing some of the buildbots to die. while True: try: # Read the exit status of any child process which already completed pid, status = os.waitpid(-1, os.WNOHANG) except OSError: break if pid == 0: break print_warning(f"reap_children() reaped child process {pid}") environment_altered = True @contextlib.contextmanager def swap_attr(obj, attr, new_val): """Temporary swap out an attribute with a new object. Usage: with swap_attr(obj, "attr", 5): ... This will set obj.attr to 5 for the duration of the with: block, restoring the old value at the end of the block. If `attr` doesn't exist on `obj`, it will be created and then deleted at the end of the block. The old value (or None if it doesn't exist) will be assigned to the target of the "as" clause, if there is one. """ if hasattr(obj, attr): real_val = getattr(obj, attr) setattr(obj, attr, new_val) try: yield real_val finally: setattr(obj, attr, real_val) else: setattr(obj, attr, new_val) try: yield finally: if hasattr(obj, attr): delattr(obj, attr) @contextlib.contextmanager def swap_item(obj, item, new_val): """Temporary swap out an item with a new object. Usage: with swap_item(obj, "item", 5): ... This will set obj["item"] to 5 for the duration of the with: block, restoring the old value at the end of the block. If `item` doesn't exist on `obj`, it will be created and then deleted at the end of the block. The old value (or None if it doesn't exist) will be assigned to the target of the "as" clause, if there is one. """ if item in obj: real_val = obj[item] obj[item] = new_val try: yield real_val finally: obj[item] = real_val else: obj[item] = new_val try: yield finally: if item in obj: del obj[item] def args_from_interpreter_flags(): """Return a list of command-line arguments reproducing the current settings in sys.flags and sys.warnoptions.""" import subprocess return subprocess._args_from_interpreter_flags() def optim_args_from_interpreter_flags(): """Return a list of command-line arguments reproducing the current optimization settings in sys.flags.""" import subprocess return subprocess._optim_args_from_interpreter_flags() class Matcher(object): _partial_matches = ('msg', 'message') def matches(self, d, **kwargs): """ Try to match a single dict with the supplied arguments. Keys whose values are strings and which are in self._partial_matches will be checked for partial (i.e. substring) matches. You can extend this scheme to (for example) do regular expression matching, etc. """ result = True for k in kwargs: v = kwargs[k] dv = d.get(k) if not self.match_value(k, dv, v): result = False break return result def match_value(self, k, dv, v): """ Try to match a single stored value (dv) with a supplied value (v). """ if type(v) != type(dv): result = False elif type(dv) is not str or k not in self._partial_matches: result = (v == dv) else: result = dv.find(v) >= 0 return result _buggy_ucrt = None def skip_if_buggy_ucrt_strfptime(test): """ Skip decorator for tests that use buggy strptime/strftime If the UCRT bugs are present time.localtime().tm_zone will be an empty string, otherwise we assume the UCRT bugs are fixed See bpo-37552 [Windows] strptime/strftime return invalid results with UCRT version 17763.615 """ import locale global _buggy_ucrt if _buggy_ucrt is None: if(sys.platform == 'win32' and locale.getdefaultlocale()[1] == 'cp65001' and time.localtime().tm_zone == ''): _buggy_ucrt = True else: _buggy_ucrt = False return unittest.skip("buggy MSVC UCRT strptime/strftime")(test) if _buggy_ucrt else test class PythonSymlink: """Creates a symlink for the current Python executable""" def __init__(self, link=None): from .os_helper import TESTFN self.link = link or os.path.abspath(TESTFN) self._linked = [] self.real = os.path.realpath(sys.executable) self._also_link = [] self._env = None self._platform_specific() if sys.platform == "win32": def _platform_specific(self): import glob import _winapi if os.path.lexists(self.real) and not os.path.exists(self.real): # App symlink appears to not exist, but we want the # real executable here anyway self.real = _winapi.GetModuleFileName(0) dll = _winapi.GetModuleFileName(sys.dllhandle) src_dir = os.path.dirname(dll) dest_dir = os.path.dirname(self.link) self._also_link.append(( dll, os.path.join(dest_dir, os.path.basename(dll)) )) for runtime in glob.glob(os.path.join(glob.escape(src_dir), "vcruntime*.dll")): self._also_link.append(( runtime, os.path.join(dest_dir, os.path.basename(runtime)) )) self._env = {k.upper(): os.getenv(k) for k in os.environ} self._env["PYTHONHOME"] = os.path.dirname(self.real) if sysconfig.is_python_build(True): self._env["PYTHONPATH"] = os.path.dirname(os.__file__) else: def _platform_specific(self): pass def __enter__(self): os.symlink(self.real, self.link) self._linked.append(self.link) for real, link in self._also_link: os.symlink(real, link) self._linked.append(link) return self def __exit__(self, exc_type, exc_value, exc_tb): for link in self._linked: try: os.remove(link) except IOError as ex: if verbose: print("failed to clean up {}: {}".format(link, ex)) def _call(self, python, args, env, returncode): import subprocess cmd = [python, *args] p = subprocess.Popen(cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE, env=env) r = p.communicate() if p.returncode != returncode: if verbose: print(repr(r[0])) print(repr(r[1]), file=sys.stderr) raise RuntimeError( 'unexpected return code: {0} (0x{0:08X})'.format(p.returncode)) return r def call_real(self, *args, returncode=0): return self._call(self.real, args, None, returncode) def call_link(self, *args, returncode=0): return self._call(self.link, args, self._env, returncode) def skip_if_pgo_task(test): """Skip decorator for tests not run in (non-extended) PGO task""" ok = not PGO or PGO_EXTENDED msg = "Not run for (non-extended) PGO task" return test if ok else unittest.skip(msg)(test) def detect_api_mismatch(ref_api, other_api, *, ignore=()): """Returns the set of items in ref_api not in other_api, except for a defined list of items to be ignored in this check. By default this skips private attributes beginning with '_' but includes all magic methods, i.e. those starting and ending in '__'. """ missing_items = set(dir(ref_api)) - set(dir(other_api)) if ignore: missing_items -= set(ignore) missing_items = set(m for m in missing_items if not m.startswith('_') or m.endswith('__')) return missing_items def check__all__(test_case, module, name_of_module=None, extra=(), not_exported=()): """Assert that the __all__ variable of 'module' contains all public names. The module's public names (its API) are detected automatically based on whether they match the public name convention and were defined in 'module'. The 'name_of_module' argument can specify (as a string or tuple thereof) what module(s) an API could be defined in in order to be detected as a public API. One case for this is when 'module' imports part of its public API from other modules, possibly a C backend (like 'csv' and its '_csv'). The 'extra' argument can be a set of names that wouldn't otherwise be automatically detected as "public", like objects without a proper '__module__' attribute. If provided, it will be added to the automatically detected ones. The 'not_exported' argument can be a set of names that must not be treated as part of the public API even though their names indicate otherwise. Usage: import bar import foo import unittest from test import support class MiscTestCase(unittest.TestCase): def test__all__(self): support.check__all__(self, foo) class OtherTestCase(unittest.TestCase): def test__all__(self): extra = {'BAR_CONST', 'FOO_CONST'} not_exported = {'baz'} # Undocumented name. # bar imports part of its API from _bar. support.check__all__(self, bar, ('bar', '_bar'), extra=extra, not_exported=not_exported) """ if name_of_module is None: name_of_module = (module.__name__, ) elif isinstance(name_of_module, str): name_of_module = (name_of_module, ) expected = set(extra) for name in dir(module): if name.startswith('_') or name in not_exported: continue obj = getattr(module, name) if (getattr(obj, '__module__', None) in name_of_module or (not hasattr(obj, '__module__') and not isinstance(obj, types.ModuleType))): expected.add(name) test_case.assertCountEqual(module.__all__, expected) def suppress_msvcrt_asserts(verbose=False): try: import msvcrt except ImportError: return msvcrt.SetErrorMode(msvcrt.SEM_FAILCRITICALERRORS | msvcrt.SEM_NOALIGNMENTFAULTEXCEPT | msvcrt.SEM_NOGPFAULTERRORBOX | msvcrt.SEM_NOOPENFILEERRORBOX) # CrtSetReportMode() is only available in debug build if hasattr(msvcrt, 'CrtSetReportMode'): for m in [msvcrt.CRT_WARN, msvcrt.CRT_ERROR, msvcrt.CRT_ASSERT]: if verbose: msvcrt.CrtSetReportMode(m, msvcrt.CRTDBG_MODE_FILE) msvcrt.CrtSetReportFile(m, msvcrt.CRTDBG_FILE_STDERR) else: msvcrt.CrtSetReportMode(m, 0) class SuppressCrashReport: """Try to prevent a crash report from popping up. On Windows, don't display the Windows Error Reporting dialog. On UNIX, disable the creation of coredump file. """ old_value = None old_modes = None def __enter__(self): """On Windows, disable Windows Error Reporting dialogs using SetErrorMode() and CrtSetReportMode(). On UNIX, try to save the previous core file size limit, then set soft limit to 0. """ if sys.platform.startswith('win'): # see http://msdn.microsoft.com/en-us/library/windows/desktop/ms680621.aspx try: import msvcrt except ImportError: return self.old_value = msvcrt.GetErrorMode() msvcrt.SetErrorMode(self.old_value | msvcrt.SEM_NOGPFAULTERRORBOX) # bpo-23314: Suppress assert dialogs in debug builds. # CrtSetReportMode() is only available in debug build. if hasattr(msvcrt, 'CrtSetReportMode'): self.old_modes = {} for report_type in [msvcrt.CRT_WARN, msvcrt.CRT_ERROR, msvcrt.CRT_ASSERT]: old_mode = msvcrt.CrtSetReportMode(report_type, msvcrt.CRTDBG_MODE_FILE) old_file = msvcrt.CrtSetReportFile(report_type, msvcrt.CRTDBG_FILE_STDERR) self.old_modes[report_type] = old_mode, old_file else: try: import resource self.resource = resource except ImportError: self.resource = None if self.resource is not None: try: self.old_value = self.resource.getrlimit(self.resource.RLIMIT_CORE) self.resource.setrlimit(self.resource.RLIMIT_CORE, (0, self.old_value[1])) except (ValueError, OSError): pass if sys.platform == 'darwin': import subprocess # Check if the 'Crash Reporter' on OSX was configured # in 'Developer' mode and warn that it will get triggered # when it is. # # This assumes that this context manager is used in tests # that might trigger the next manager. cmd = ['/usr/bin/defaults', 'read', 'com.apple.CrashReporter', 'DialogType'] proc = subprocess.Popen(cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE) with proc: stdout = proc.communicate()[0] if stdout.strip() == b'developer': print("this test triggers the Crash Reporter, " "that is intentional", end='', flush=True) return self def __exit__(self, *ignore_exc): """Restore Windows ErrorMode or core file behavior to initial value.""" if self.old_value is None: return if sys.platform.startswith('win'): import msvcrt msvcrt.SetErrorMode(self.old_value) if self.old_modes: for report_type, (old_mode, old_file) in self.old_modes.items(): msvcrt.CrtSetReportMode(report_type, old_mode) msvcrt.CrtSetReportFile(report_type, old_file) else: if self.resource is not None: try: self.resource.setrlimit(self.resource.RLIMIT_CORE, self.old_value) except (ValueError, OSError): pass def patch(test_instance, object_to_patch, attr_name, new_value): """Override 'object_to_patch'.'attr_name' with 'new_value'. Also, add a cleanup procedure to 'test_instance' to restore 'object_to_patch' value for 'attr_name'. The 'attr_name' should be a valid attribute for 'object_to_patch'. """ # check that 'attr_name' is a real attribute for 'object_to_patch' # will raise AttributeError if it does not exist getattr(object_to_patch, attr_name) # keep a copy of the old value attr_is_local = False try: old_value = object_to_patch.__dict__[attr_name] except (AttributeError, KeyError): old_value = getattr(object_to_patch, attr_name, None) else: attr_is_local = True # restore the value when the test is done def cleanup(): if attr_is_local: setattr(object_to_patch, attr_name, old_value) else: delattr(object_to_patch, attr_name) test_instance.addCleanup(cleanup) # actually override the attribute setattr(object_to_patch, attr_name, new_value) @contextlib.contextmanager def patch_list(orig): """Like unittest.mock.patch.dict, but for lists.""" try: saved = orig[:] yield finally: orig[:] = saved def run_in_subinterp(code): """ Run code in a subinterpreter. Raise unittest.SkipTest if the tracemalloc module is enabled. """ # Issue #10915, #15751: PyGILState_*() functions don't work with # sub-interpreters, the tracemalloc module uses these functions internally try: import tracemalloc except ImportError: pass else: if tracemalloc.is_tracing(): raise unittest.SkipTest("run_in_subinterp() cannot be used " "if tracemalloc module is tracing " "memory allocations") import _testcapi return _testcapi.run_in_subinterp(code) def check_free_after_iterating(test, iter, cls, args=()): class A(cls): def __del__(self): nonlocal done done = True try: next(it) except StopIteration: pass done = False it = iter(A(*args)) # Issue 26494: Shouldn't crash test.assertRaises(StopIteration, next, it) # The sequence should be deallocated just after the end of iterating gc_collect() test.assertTrue(done) def missing_compiler_executable(cmd_names=[]): """Check if the compiler components used to build the interpreter exist. Check for the existence of the compiler executables whose names are listed in 'cmd_names' or all the compiler executables when 'cmd_names' is empty and return the first missing executable or None when none is found missing. """ # TODO (PEP 632): alternate check without using distutils from distutils import ccompiler, sysconfig, spawn, errors compiler = ccompiler.new_compiler() sysconfig.customize_compiler(compiler) if compiler.compiler_type == "msvc": # MSVC has no executables, so check whether initialization succeeds try: compiler.initialize() except errors.DistutilsPlatformError: return "msvc" for name in compiler.executables: if cmd_names and name not in cmd_names: continue cmd = getattr(compiler, name) if cmd_names: assert cmd is not None, \ "the '%s' executable is not configured" % name elif not cmd: continue if spawn.find_executable(cmd[0]) is None: return cmd[0] _is_android_emulator = None def setswitchinterval(interval): # Setting a very low gil interval on the Android emulator causes python # to hang (issue #26939). minimum_interval = 1e-5 if is_android and interval < minimum_interval: global _is_android_emulator if _is_android_emulator is None: import subprocess _is_android_emulator = (subprocess.check_output( ['getprop', 'ro.kernel.qemu']).strip() == b'1') if _is_android_emulator: interval = minimum_interval return sys.setswitchinterval(interval) @contextlib.contextmanager def disable_faulthandler(): import faulthandler # use sys.__stderr__ instead of sys.stderr, since regrtest replaces # sys.stderr with a StringIO which has no file descriptor when a test # is run with -W/--verbose3. fd = sys.__stderr__.fileno() is_enabled = faulthandler.is_enabled() try: faulthandler.disable() yield finally: if is_enabled: faulthandler.enable(file=fd, all_threads=True) class SaveSignals: """ Save and restore signal handlers. This class is only able to save/restore signal handlers registered by the Python signal module: see bpo-13285 for "external" signal handlers. """ def __init__(self): import signal self.signal = signal self.signals = signal.valid_signals() # SIGKILL and SIGSTOP signals cannot be ignored nor caught for signame in ('SIGKILL', 'SIGSTOP'): try: signum = getattr(signal, signame) except AttributeError: continue self.signals.remove(signum) self.handlers = {} def save(self): for signum in self.signals: handler = self.signal.getsignal(signum) if handler is None: # getsignal() returns None if a signal handler was not # registered by the Python signal module, # and the handler is not SIG_DFL nor SIG_IGN. # # Ignore the signal: we cannot restore the handler. continue self.handlers[signum] = handler def restore(self): for signum, handler in self.handlers.items(): self.signal.signal(signum, handler) def with_pymalloc(): import _testcapi return _testcapi.WITH_PYMALLOC class _ALWAYS_EQ: """ Object that is equal to anything. """ def __eq__(self, other): return True def __ne__(self, other): return False ALWAYS_EQ = _ALWAYS_EQ() class _NEVER_EQ: """ Object that is not equal to anything. """ def __eq__(self, other): return False def __ne__(self, other): return True def __hash__(self): return 1 NEVER_EQ = _NEVER_EQ() @functools.total_ordering class _LARGEST: """ Object that is greater than anything (except itself). """ def __eq__(self, other): return isinstance(other, _LARGEST) def __lt__(self, other): return False LARGEST = _LARGEST() @functools.total_ordering class _SMALLEST: """ Object that is less than anything (except itself). """ def __eq__(self, other): return isinstance(other, _SMALLEST) def __gt__(self, other): return False SMALLEST = _SMALLEST() def maybe_get_event_loop_policy(): """Return the global event loop policy if one is set, else return None.""" import asyncio.events return asyncio.events._event_loop_policy # Helpers for testing hashing. NHASHBITS = sys.hash_info.width # number of bits in hash() result assert NHASHBITS in (32, 64) # Return mean and sdev of number of collisions when tossing nballs balls # uniformly at random into nbins bins. By definition, the number of # collisions is the number of balls minus the number of occupied bins at # the end. def collision_stats(nbins, nballs): n, k = nbins, nballs # prob a bin empty after k trials = (1 - 1/n)**k # mean # empty is then n * (1 - 1/n)**k # so mean # occupied is n - n * (1 - 1/n)**k # so collisions = k - (n - n*(1 - 1/n)**k) # # For the variance: # n*(n-1)*(1-2/n)**k + meanempty - meanempty**2 = # n*(n-1)*(1-2/n)**k + meanempty * (1 - meanempty) # # Massive cancellation occurs, and, e.g., for a 64-bit hash code # 1-1/2**64 rounds uselessly to 1.0. Rather than make heroic (and # error-prone) efforts to rework the naive formulas to avoid those, # we use the `decimal` module to get plenty of extra precision. # # Note: the exact values are straightforward to compute with # rationals, but in context that's unbearably slow, requiring # multi-million bit arithmetic. import decimal with decimal.localcontext() as ctx: bits = n.bit_length() * 2 # bits in n**2 # At least that many bits will likely cancel out. # Use that many decimal digits instead. ctx.prec = max(bits, 30) dn = decimal.Decimal(n) p1empty = ((dn - 1) / dn) ** k meanempty = n * p1empty occupied = n - meanempty collisions = k - occupied var = dn*(dn-1)*((dn-2)/dn)**k + meanempty * (1 - meanempty) return float(collisions), float(var.sqrt()) class catch_unraisable_exception: """ Context manager catching unraisable exception using sys.unraisablehook. Storing the exception value (cm.unraisable.exc_value) creates a reference cycle. The reference cycle is broken explicitly when the context manager exits. Storing the object (cm.unraisable.object) can resurrect it if it is set to an object which is being finalized. Exiting the context manager clears the stored object. Usage: with support.catch_unraisable_exception() as cm: # code creating an "unraisable exception" ... # check the unraisable exception: use cm.unraisable ... # cm.unraisable attribute no longer exists at this point # (to break a reference cycle) """ def __init__(self): self.unraisable = None self._old_hook = None def _hook(self, unraisable): # Storing unraisable.object can resurrect an object which is being # finalized. Storing unraisable.exc_value creates a reference cycle. self.unraisable = unraisable def __enter__(self): self._old_hook = sys.unraisablehook sys.unraisablehook = self._hook return self def __exit__(self, *exc_info): sys.unraisablehook = self._old_hook del self.unraisable def wait_process(pid, *, exitcode, timeout=None): """ Wait until process pid completes and check that the process exit code is exitcode. Raise an AssertionError if the process exit code is not equal to exitcode. If the process runs longer than timeout seconds (LONG_TIMEOUT by default), kill the process (if signal.SIGKILL is available) and raise an AssertionError. The timeout feature is not available on Windows. """ if os.name != "nt": import signal if timeout is None: timeout = LONG_TIMEOUT t0 = time.monotonic() sleep = 0.001 max_sleep = 0.1 while True: pid2, status = os.waitpid(pid, os.WNOHANG) if pid2 != 0: break # process is still running dt = time.monotonic() - t0 if dt > timeout: try: os.kill(pid, signal.SIGKILL) os.waitpid(pid, 0) except OSError: # Ignore errors like ChildProcessError or PermissionError pass raise AssertionError(f"process {pid} is still running " f"after {dt:.1f} seconds") sleep = min(sleep * 2, max_sleep) time.sleep(sleep) else: # Windows implementation pid2, status = os.waitpid(pid, 0) exitcode2 = os.waitstatus_to_exitcode(status) if exitcode2 != exitcode: raise AssertionError(f"process {pid} exited with code {exitcode2}, " f"but exit code {exitcode} is expected") # sanity check: it should not fail in practice if pid2 != pid: raise AssertionError(f"pid {pid2} != pid {pid}") def skip_if_broken_multiprocessing_synchronize(): """ Skip tests if the multiprocessing.synchronize module is missing, if there is no available semaphore implementation, or if creating a lock raises an OSError (on Linux only). """ from .import_helper import import_module # Skip tests if the _multiprocessing extension is missing. import_module('_multiprocessing') # Skip tests if there is no available semaphore implementation: # multiprocessing.synchronize requires _multiprocessing.SemLock. synchronize = import_module('multiprocessing.synchronize') if sys.platform == "linux": try: # bpo-38377: On Linux, creating a semaphore fails with OSError # if the current user does not have the permission to create # a file in /dev/shm/ directory. synchronize.Lock(ctx=None) except OSError as exc: raise unittest.SkipTest(f"broken multiprocessing SemLock: {exc!r}") @contextlib.contextmanager def infinite_recursion(max_depth=75): original_depth = sys.getrecursionlimit() try: sys.setrecursionlimit(max_depth) yield finally: sys.setrecursionlimit(original_depth) def check_disallow_instantiation(testcase, tp, *args, **kwds): """ Check that given type cannot be instantiated using *args and **kwds. See bpo-43916: Add Py_TPFLAGS_DISALLOW_INSTANTIATION type flag. """ mod = tp.__module__ name = tp.__name__ if mod != 'builtins': qualname = f"{mod}.{name}" else: qualname = f"{name}" msg = f"cannot create '{re.escape(qualname)}' instances" testcase.assertRaisesRegex(TypeError, msg, tp, *args, **kwds) def ignore_deprecations_from(module: str, *, like: str) -> object: token = object() warnings.filterwarnings( "ignore", category=DeprecationWarning, module=module, message=like + fr"(?#support{id(token)})", ) return token def clear_ignored_deprecations(*tokens: object) -> None: if not tokens: raise ValueError("Provide token or tokens returned by ignore_deprecations_from") new_filters = [] endswith = tuple(rf"(?#support{id(token)})" for token in tokens) for action, message, category, module, lineno in warnings.filters: if action == "ignore" and category is DeprecationWarning: if isinstance(message, re.Pattern): msg = message.pattern else: msg = message or "" if msg.endswith(endswith): continue new_filters.append((action, message, category, module, lineno)) if warnings.filters != new_filters: warnings.filters[:] = new_filters warnings._filters_mutated() @contextlib.contextmanager def adjust_int_max_str_digits(max_digits): """Temporarily change the integer string conversion length limit.""" current = sys.get_int_max_str_digits() try: sys.set_int_max_str_digits(max_digits) yield finally: sys.set_int_max_str_digits(current) def control_characters_c0() -> list[str]: """Returns a list of C0 control characters as strings. C0 control characters defined as the byte range 0x00-0x1F, and 0x7F. """ return [chr(c) for c in range(0x00, 0x20)] + ["\x7F"] PK ! E����M �M os_helper.pynu �[��� import collections.abc import contextlib import errno import os import re import stat import sys import time import unittest import warnings # Filename used for testing if os.name == 'java': # Jython disallows @ in module names TESTFN_ASCII = '$test' else: TESTFN_ASCII = '@test' # Disambiguate TESTFN for parallel testing, while letting it remain a valid # module name. TESTFN_ASCII = "{}_{}_tmp".format(TESTFN_ASCII, os.getpid()) # TESTFN_UNICODE is a non-ascii filename TESTFN_UNICODE = TESTFN_ASCII + "-\xe0\xf2\u0258\u0141\u011f" if sys.platform == 'darwin': # In Mac OS X's VFS API file names are, by definition, canonically # decomposed Unicode, encoded using UTF-8. See QA1173: # http://developer.apple.com/mac/library/qa/qa2001/qa1173.html import unicodedata TESTFN_UNICODE = unicodedata.normalize('NFD', TESTFN_UNICODE) # TESTFN_UNENCODABLE is a filename (str type) that should *not* be able to be # encoded by the filesystem encoding (in strict mode). It can be None if we # cannot generate such filename. TESTFN_UNENCODABLE = None if os.name == 'nt': # skip win32s (0) or Windows 9x/ME (1) if sys.getwindowsversion().platform >= 2: # Different kinds of characters from various languages to minimize the # probability that the whole name is encodable to MBCS (issue #9819) TESTFN_UNENCODABLE = TESTFN_ASCII + "-\u5171\u0141\u2661\u0363\uDC80" try: TESTFN_UNENCODABLE.encode(sys.getfilesystemencoding()) except UnicodeEncodeError: pass else: print('WARNING: The filename %r CAN be encoded by the filesystem ' 'encoding (%s). Unicode filename tests may not be effective' % (TESTFN_UNENCODABLE, sys.getfilesystemencoding())) TESTFN_UNENCODABLE = None # Mac OS X denies unencodable filenames (invalid utf-8) elif sys.platform != 'darwin': try: # ascii and utf-8 cannot encode the byte 0xff b'\xff'.decode(sys.getfilesystemencoding()) except UnicodeDecodeError: # 0xff will be encoded using the surrogate character u+DCFF TESTFN_UNENCODABLE = TESTFN_ASCII \ + b'-\xff'.decode(sys.getfilesystemencoding(), 'surrogateescape') else: # File system encoding (eg. ISO-8859-* encodings) can encode # the byte 0xff. Skip some unicode filename tests. pass # FS_NONASCII: non-ASCII character encodable by os.fsencode(), # or an empty string if there is no such character. FS_NONASCII = '' for character in ( # First try printable and common characters to have a readable filename. # For each character, the encoding list are just example of encodings able # to encode the character (the list is not exhaustive). # U+00E6 (Latin Small Letter Ae): cp1252, iso-8859-1 '\u00E6', # U+0130 (Latin Capital Letter I With Dot Above): cp1254, iso8859_3 '\u0130', # U+0141 (Latin Capital Letter L With Stroke): cp1250, cp1257 '\u0141', # U+03C6 (Greek Small Letter Phi): cp1253 '\u03C6', # U+041A (Cyrillic Capital Letter Ka): cp1251 '\u041A', # U+05D0 (Hebrew Letter Alef): Encodable to cp424 '\u05D0', # U+060C (Arabic Comma): cp864, cp1006, iso8859_6, mac_arabic '\u060C', # U+062A (Arabic Letter Teh): cp720 '\u062A', # U+0E01 (Thai Character Ko Kai): cp874 '\u0E01', # Then try more "special" characters. "special" because they may be # interpreted or displayed differently depending on the exact locale # encoding and the font. # U+00A0 (No-Break Space) '\u00A0', # U+20AC (Euro Sign) '\u20AC', ): try: # If Python is set up to use the legacy 'mbcs' in Windows, # 'replace' error mode is used, and encode() returns b'?' # for characters missing in the ANSI codepage if os.fsdecode(os.fsencode(character)) != character: raise UnicodeError except UnicodeError: pass else: FS_NONASCII = character break # Save the initial cwd SAVEDCWD = os.getcwd() # TESTFN_UNDECODABLE is a filename (bytes type) that should *not* be able to be # decoded from the filesystem encoding (in strict mode). It can be None if we # cannot generate such filename (ex: the latin1 encoding can decode any byte # sequence). On UNIX, TESTFN_UNDECODABLE can be decoded by os.fsdecode() thanks # to the surrogateescape error handler (PEP 383), but not from the filesystem # encoding in strict mode. TESTFN_UNDECODABLE = None for name in ( # b'\xff' is not decodable by os.fsdecode() with code page 932. Windows # accepts it to create a file or a directory, or don't accept to enter to # such directory (when the bytes name is used). So test b'\xe7' first: # it is not decodable from cp932. b'\xe7w\xf0', # undecodable from ASCII, UTF-8 b'\xff', # undecodable from iso8859-3, iso8859-6, iso8859-7, cp424, iso8859-8, cp856 # and cp857 b'\xae\xd5' # undecodable from UTF-8 (UNIX and Mac OS X) b'\xed\xb2\x80', b'\xed\xb4\x80', # undecodable from shift_jis, cp869, cp874, cp932, cp1250, cp1251, cp1252, # cp1253, cp1254, cp1255, cp1257, cp1258 b'\x81\x98', ): try: name.decode(sys.getfilesystemencoding()) except UnicodeDecodeError: TESTFN_UNDECODABLE = os.fsencode(TESTFN_ASCII) + name break if FS_NONASCII: TESTFN_NONASCII = TESTFN_ASCII + FS_NONASCII else: TESTFN_NONASCII = None TESTFN = TESTFN_NONASCII or TESTFN_ASCII def make_bad_fd(): """ Create an invalid file descriptor by opening and closing a file and return its fd. """ file = open(TESTFN, "wb") try: return file.fileno() finally: file.close() unlink(TESTFN) _can_symlink = None def can_symlink(): global _can_symlink if _can_symlink is not None: return _can_symlink symlink_path = TESTFN + "can_symlink" try: os.symlink(TESTFN, symlink_path) can = True except (OSError, NotImplementedError, AttributeError): can = False else: os.remove(symlink_path) _can_symlink = can return can def skip_unless_symlink(test): """Skip decorator for tests that require functional symlink""" ok = can_symlink() msg = "Requires functional symlink implementation" return test if ok else unittest.skip(msg)(test) _can_xattr = None def can_xattr(): import tempfile global _can_xattr if _can_xattr is not None: return _can_xattr if not hasattr(os, "setxattr"): can = False else: import platform tmp_dir = tempfile.mkdtemp() tmp_fp, tmp_name = tempfile.mkstemp(dir=tmp_dir) try: with open(TESTFN, "wb") as fp: try: # TESTFN & tempfile may use different file systems with # different capabilities os.setxattr(tmp_fp, b"user.test", b"") os.setxattr(tmp_name, b"trusted.foo", b"42") os.setxattr(fp.fileno(), b"user.test", b"") # Kernels < 2.6.39 don't respect setxattr flags. kernel_version = platform.release() m = re.match(r"2.6.(\d{1,2})", kernel_version) can = m is None or int(m.group(1)) >= 39 except OSError: can = False finally: unlink(TESTFN) unlink(tmp_name) rmdir(tmp_dir) _can_xattr = can return can def skip_unless_xattr(test): """Skip decorator for tests that require functional extended attributes""" ok = can_xattr() msg = "no non-broken extended attribute support" return test if ok else unittest.skip(msg)(test) def unlink(filename): try: _unlink(filename) except (FileNotFoundError, NotADirectoryError): pass if sys.platform.startswith("win"): def _waitfor(func, pathname, waitall=False): # Perform the operation func(pathname) # Now setup the wait loop if waitall: dirname = pathname else: dirname, name = os.path.split(pathname) dirname = dirname or '.' # Check for `pathname` to be removed from the filesystem. # The exponential backoff of the timeout amounts to a total # of ~1 second after which the deletion is probably an error # anyway. # Testing on an i7@4.3GHz shows that usually only 1 iteration is # required when contention occurs. timeout = 0.001 while timeout < 1.0: # Note we are only testing for the existence of the file(s) in # the contents of the directory regardless of any security or # access rights. If we have made it this far, we have sufficient # permissions to do that much using Python's equivalent of the # Windows API FindFirstFile. # Other Windows APIs can fail or give incorrect results when # dealing with files that are pending deletion. L = os.listdir(dirname) if not (L if waitall else name in L): return # Increase the timeout and try again time.sleep(timeout) timeout *= 2 warnings.warn('tests may fail, delete still pending for ' + pathname, RuntimeWarning, stacklevel=4) def _unlink(filename): _waitfor(os.unlink, filename) def _rmdir(dirname): _waitfor(os.rmdir, dirname) def _rmtree(path): from test.support import _force_run def _rmtree_inner(path): for name in _force_run(path, os.listdir, path): fullname = os.path.join(path, name) try: mode = os.lstat(fullname).st_mode except OSError as exc: print("support.rmtree(): os.lstat(%r) failed with %s" % (fullname, exc), file=sys.__stderr__) mode = 0 if stat.S_ISDIR(mode): _waitfor(_rmtree_inner, fullname, waitall=True) _force_run(fullname, os.rmdir, fullname) else: _force_run(fullname, os.unlink, fullname) _waitfor(_rmtree_inner, path, waitall=True) _waitfor(lambda p: _force_run(p, os.rmdir, p), path) def _longpath(path): try: import ctypes except ImportError: # No ctypes means we can't expands paths. pass else: buffer = ctypes.create_unicode_buffer(len(path) * 2) length = ctypes.windll.kernel32.GetLongPathNameW(path, buffer, len(buffer)) if length: return buffer[:length] return path else: _unlink = os.unlink _rmdir = os.rmdir def _rmtree(path): import shutil try: shutil.rmtree(path) return except OSError: pass def _rmtree_inner(path): from test.support import _force_run for name in _force_run(path, os.listdir, path): fullname = os.path.join(path, name) try: mode = os.lstat(fullname).st_mode except OSError: mode = 0 if stat.S_ISDIR(mode): _rmtree_inner(fullname) _force_run(path, os.rmdir, fullname) else: _force_run(path, os.unlink, fullname) _rmtree_inner(path) os.rmdir(path) def _longpath(path): return path def rmdir(dirname): try: _rmdir(dirname) except FileNotFoundError: pass def rmtree(path): try: _rmtree(path) except FileNotFoundError: pass @contextlib.contextmanager def temp_dir(path=None, quiet=False): """Return a context manager that creates a temporary directory. Arguments: path: the directory to create temporarily. If omitted or None, defaults to creating a temporary directory using tempfile.mkdtemp. quiet: if False (the default), the context manager raises an exception on error. Otherwise, if the path is specified and cannot be created, only a warning is issued. """ import tempfile dir_created = False if path is None: path = tempfile.mkdtemp() dir_created = True path = os.path.realpath(path) else: try: os.mkdir(path) dir_created = True except OSError as exc: if not quiet: raise warnings.warn(f'tests may fail, unable to create ' f'temporary directory {path!r}: {exc}', RuntimeWarning, stacklevel=3) if dir_created: pid = os.getpid() try: yield path finally: # In case the process forks, let only the parent remove the # directory. The child has a different process id. (bpo-30028) if dir_created and pid == os.getpid(): rmtree(path) @contextlib.contextmanager def change_cwd(path, quiet=False): """Return a context manager that changes the current working directory. Arguments: path: the directory to use as the temporary current working directory. quiet: if False (the default), the context manager raises an exception on error. Otherwise, it issues only a warning and keeps the current working directory the same. """ saved_dir = os.getcwd() try: os.chdir(os.path.realpath(path)) except OSError as exc: if not quiet: raise warnings.warn(f'tests may fail, unable to change the current working ' f'directory to {path!r}: {exc}', RuntimeWarning, stacklevel=3) try: yield os.getcwd() finally: os.chdir(saved_dir) @contextlib.contextmanager def temp_cwd(name='tempcwd', quiet=False): """ Context manager that temporarily creates and changes the CWD. The function temporarily changes the current working directory after creating a temporary directory in the current directory with name *name*. If *name* is None, the temporary directory is created using tempfile.mkdtemp. If *quiet* is False (default) and it is not possible to create or change the CWD, an error is raised. If *quiet* is True, only a warning is raised and the original CWD is used. """ with temp_dir(path=name, quiet=quiet) as temp_path: with change_cwd(temp_path, quiet=quiet) as cwd_dir: yield cwd_dir def create_empty_file(filename): """Create an empty file. If the file already exists, truncate it.""" fd = os.open(filename, os.O_WRONLY | os.O_CREAT | os.O_TRUNC) os.close(fd) @contextlib.contextmanager def open_dir_fd(path): """Open a file descriptor to a directory.""" assert os.path.isdir(path) dir_fd = os.open(path, os.O_RDONLY) try: yield dir_fd finally: os.close(dir_fd) def fs_is_case_insensitive(directory): """Detects if the file system for the specified directory is case-insensitive.""" import tempfile with tempfile.NamedTemporaryFile(dir=directory) as base: base_path = base.name case_path = base_path.upper() if case_path == base_path: case_path = base_path.lower() try: return os.path.samefile(base_path, case_path) except FileNotFoundError: return False class FakePath: """Simple implementing of the path protocol. """ def __init__(self, path): self.path = path def __repr__(self): return f'<FakePath {self.path!r}>' def __fspath__(self): if (isinstance(self.path, BaseException) or isinstance(self.path, type) and issubclass(self.path, BaseException)): raise self.path else: return self.path def fd_count(): """Count the number of open file descriptors. """ if sys.platform.startswith(('linux', 'freebsd')): try: names = os.listdir("/proc/self/fd") # Subtract one because listdir() internally opens a file # descriptor to list the content of the /proc/self/fd/ directory. return len(names) - 1 except FileNotFoundError: pass MAXFD = 256 if hasattr(os, 'sysconf'): try: MAXFD = os.sysconf("SC_OPEN_MAX") except OSError: pass old_modes = None if sys.platform == 'win32': # bpo-25306, bpo-31009: Call CrtSetReportMode() to not kill the process # on invalid file descriptor if Python is compiled in debug mode try: import msvcrt msvcrt.CrtSetReportMode except (AttributeError, ImportError): # no msvcrt or a release build pass else: old_modes = {} for report_type in (msvcrt.CRT_WARN, msvcrt.CRT_ERROR, msvcrt.CRT_ASSERT): old_modes[report_type] = msvcrt.CrtSetReportMode(report_type, 0) try: count = 0 for fd in range(MAXFD): try: # Prefer dup() over fstat(). fstat() can require input/output # whereas dup() doesn't. fd2 = os.dup(fd) except OSError as e: if e.errno != errno.EBADF: raise else: os.close(fd2) count += 1 finally: if old_modes is not None: for report_type in (msvcrt.CRT_WARN, msvcrt.CRT_ERROR, msvcrt.CRT_ASSERT): msvcrt.CrtSetReportMode(report_type, old_modes[report_type]) return count if hasattr(os, "umask"): @contextlib.contextmanager def temp_umask(umask): """Context manager that temporarily sets the process umask.""" oldmask = os.umask(umask) try: yield finally: os.umask(oldmask) class EnvironmentVarGuard(collections.abc.MutableMapping): """Class to help protect the environment variable properly. Can be used as a context manager.""" def __init__(self): self._environ = os.environ self._changed = {} def __getitem__(self, envvar): return self._environ[envvar] def __setitem__(self, envvar, value): # Remember the initial value on the first access if envvar not in self._changed: self._changed[envvar] = self._environ.get(envvar) self._environ[envvar] = value def __delitem__(self, envvar): # Remember the initial value on the first access if envvar not in self._changed: self._changed[envvar] = self._environ.get(envvar) if envvar in self._environ: del self._environ[envvar] def keys(self): return self._environ.keys() def __iter__(self): return iter(self._environ) def __len__(self): return len(self._environ) def set(self, envvar, value): self[envvar] = value def unset(self, envvar): del self[envvar] def __enter__(self): return self def __exit__(self, *ignore_exc): for (k, v) in self._changed.items(): if v is None: if k in self._environ: del self._environ[k] else: self._environ[k] = v os.environ = self._environ PK ! �0,� � threading_helper.pynu �[��� import _thread import contextlib import functools import sys import threading import time from test import support #======================================================================= # Threading support to prevent reporting refleaks when running regrtest.py -R # NOTE: we use thread._count() rather than threading.enumerate() (or the # moral equivalent thereof) because a threading.Thread object is still alive # until its __bootstrap() method has returned, even after it has been # unregistered from the threading module. # thread._count(), on the other hand, only gets decremented *after* the # __bootstrap() method has returned, which gives us reliable reference counts # at the end of a test run. def threading_setup(): return _thread._count(), threading._dangling.copy() def threading_cleanup(*original_values): _MAX_COUNT = 100 for count in range(_MAX_COUNT): values = _thread._count(), threading._dangling if values == original_values: break if not count: # Display a warning at the first iteration support.environment_altered = True dangling_threads = values[1] support.print_warning(f"threading_cleanup() failed to cleanup " f"{values[0] - original_values[0]} threads " f"(count: {values[0]}, " f"dangling: {len(dangling_threads)})") for thread in dangling_threads: support.print_warning(f"Dangling thread: {thread!r}") # Don't hold references to threads dangling_threads = None values = None time.sleep(0.01) support.gc_collect() def reap_threads(func): """Use this function when threads are being used. This will ensure that the threads are cleaned up even when the test fails. """ @functools.wraps(func) def decorator(*args): key = threading_setup() try: return func(*args) finally: threading_cleanup(*key) return decorator @contextlib.contextmanager def wait_threads_exit(timeout=None): """ bpo-31234: Context manager to wait until all threads created in the with statement exit. Use _thread.count() to check if threads exited. Indirectly, wait until threads exit the internal t_bootstrap() C function of the _thread module. threading_setup() and threading_cleanup() are designed to emit a warning if a test leaves running threads in the background. This context manager is designed to cleanup threads started by the _thread.start_new_thread() which doesn't allow to wait for thread exit, whereas thread.Thread has a join() method. """ if timeout is None: timeout = support.SHORT_TIMEOUT old_count = _thread._count() try: yield finally: start_time = time.monotonic() deadline = start_time + timeout while True: count = _thread._count() if count <= old_count: break if time.monotonic() > deadline: dt = time.monotonic() - start_time msg = (f"wait_threads() failed to cleanup {count - old_count} " f"threads after {dt:.1f} seconds " f"(count: {count}, old count: {old_count})") raise AssertionError(msg) time.sleep(0.010) support.gc_collect() def join_thread(thread, timeout=None): """Join a thread. Raise an AssertionError if the thread is still alive after timeout seconds. """ if timeout is None: timeout = support.SHORT_TIMEOUT thread.join(timeout) if thread.is_alive(): msg = f"failed to join the thread in {timeout:.1f} seconds" raise AssertionError(msg) @contextlib.contextmanager def start_threads(threads, unlock=None): import faulthandler threads = list(threads) started = [] try: try: for t in threads: t.start() started.append(t) except: if support.verbose: print("Can't start %d threads, only %d threads started" % (len(threads), len(started))) raise yield finally: try: if unlock: unlock() endtime = time.monotonic() for timeout in range(1, 16): endtime += 60 for t in started: t.join(max(endtime - time.monotonic(), 0.01)) started = [t for t in started if t.is_alive()] if not started: break if support.verbose: print('Unable to join %d threads during a period of ' '%d minutes' % (len(started), timeout)) finally: started = [t for t in started if t.is_alive()] if started: faulthandler.dump_traceback(sys.stdout) raise AssertionError('Unable to join %d threads' % len(started)) class catch_threading_exception: """ Context manager catching threading.Thread exception using threading.excepthook. Attributes set when an exception is caught: * exc_type * exc_value * exc_traceback * thread See threading.excepthook() documentation for these attributes. These attributes are deleted at the context manager exit. Usage: with threading_helper.catch_threading_exception() as cm: # code spawning a thread which raises an exception ... # check the thread exception, use cm attributes: # exc_type, exc_value, exc_traceback, thread ... # exc_type, exc_value, exc_traceback, thread attributes of cm no longer # exists at this point # (to avoid reference cycles) """ def __init__(self): self.exc_type = None self.exc_value = None self.exc_traceback = None self.thread = None self._old_hook = None def _hook(self, args): self.exc_type = args.exc_type self.exc_value = args.exc_value self.exc_traceback = args.exc_traceback self.thread = args.thread def __enter__(self): self._old_hook = threading.excepthook threading.excepthook = self._hook return self def __exit__(self, *exc_info): threading.excepthook = self._old_hook del self.exc_type del self.exc_value del self.exc_traceback del self.thread PK ! �d��� � interpreters.pynu �[��� """Subinterpreters High Level Module.""" import time import _xxsubinterpreters as _interpreters # aliases: from _xxsubinterpreters import ( ChannelError, ChannelNotFoundError, ChannelEmptyError, is_shareable, ) __all__ = [ 'Interpreter', 'get_current', 'get_main', 'create', 'list_all', 'SendChannel', 'RecvChannel', 'create_channel', 'list_all_channels', 'is_shareable', 'ChannelError', 'ChannelNotFoundError', 'ChannelEmptyError', ] def create(*, isolated=True): """Return a new (idle) Python interpreter.""" id = _interpreters.create(isolated=isolated) return Interpreter(id, isolated=isolated) def list_all(): """Return all existing interpreters.""" return [Interpreter(id) for id in _interpreters.list_all()] def get_current(): """Return the currently running interpreter.""" id = _interpreters.get_current() return Interpreter(id) def get_main(): """Return the main interpreter.""" id = _interpreters.get_main() return Interpreter(id) class Interpreter: """A single Python interpreter.""" def __init__(self, id, *, isolated=None): if not isinstance(id, (int, _interpreters.InterpreterID)): raise TypeError(f'id must be an int, got {id!r}') self._id = id self._isolated = isolated def __repr__(self): data = dict(id=int(self._id), isolated=self._isolated) kwargs = (f'{k}={v!r}' for k, v in data.items()) return f'{type(self).__name__}({", ".join(kwargs)})' def __hash__(self): return hash(self._id) def __eq__(self, other): if not isinstance(other, Interpreter): return NotImplemented else: return other._id == self._id @property def id(self): return self._id @property def isolated(self): if self._isolated is None: # XXX The low-level function has not been added yet. # See bpo-.... self._isolated = _interpreters.is_isolated(self._id) return self._isolated def is_running(self): """Return whether or not the identified interpreter is running.""" return _interpreters.is_running(self._id) def close(self): """Finalize and destroy the interpreter. Attempting to destroy the current interpreter results in a RuntimeError. """ return _interpreters.destroy(self._id) def run(self, src_str, /, *, channels=None): """Run the given source code in the interpreter. This blocks the current Python thread until done. """ _interpreters.run_string(self._id, src_str, channels) def create_channel(): """Return (recv, send) for a new cross-interpreter channel. The channel may be used to pass data safely between interpreters. """ cid = _interpreters.channel_create() recv, send = RecvChannel(cid), SendChannel(cid) return recv, send def list_all_channels(): """Return a list of (recv, send) for all open channels.""" return [(RecvChannel(cid), SendChannel(cid)) for cid in _interpreters.channel_list_all()] class _ChannelEnd: """The base class for RecvChannel and SendChannel.""" def __init__(self, id): if not isinstance(id, (int, _interpreters.ChannelID)): raise TypeError(f'id must be an int, got {id!r}') self._id = id def __repr__(self): return f'{type(self).__name__}(id={int(self._id)})' def __hash__(self): return hash(self._id) def __eq__(self, other): if isinstance(self, RecvChannel): if not isinstance(other, RecvChannel): return NotImplemented elif not isinstance(other, SendChannel): return NotImplemented return other._id == self._id @property def id(self): return self._id _NOT_SET = object() class RecvChannel(_ChannelEnd): """The receiving end of a cross-interpreter channel.""" def recv(self, *, _sentinel=object(), _delay=10 / 1000): # 10 milliseconds """Return the next object from the channel. This blocks until an object has been sent, if none have been sent already. """ obj = _interpreters.channel_recv(self._id, _sentinel) while obj is _sentinel: time.sleep(_delay) obj = _interpreters.channel_recv(self._id, _sentinel) return obj def recv_nowait(self, default=_NOT_SET): """Return the next object from the channel. If none have been sent then return the default if one is provided or fail with ChannelEmptyError. Otherwise this is the same as recv(). """ if default is _NOT_SET: return _interpreters.channel_recv(self._id) else: return _interpreters.channel_recv(self._id, default) class SendChannel(_ChannelEnd): """The sending end of a cross-interpreter channel.""" def send(self, obj): """Send the object (i.e. its data) to the channel's receiving end. This blocks until the object is received. """ _interpreters.channel_send(self._id, obj) # XXX We are missing a low-level channel_send_wait(). # See bpo-32604 and gh-19829. # Until that shows up we fake it: time.sleep(2) def send_nowait(self, obj): """Send the object to the channel's receiving end. If the object is immediately received then return True (else False). Otherwise this is the same as send(). """ # XXX Note that at the moment channel_send() only ever returns # None. This should be fixed when channel_send_wait() is added. # See bpo-32604 and gh-19829. return _interpreters.channel_send(self._id, obj) PK ! ��H�� � warnings_helper.pynu �[��� import contextlib import functools import re import sys import warnings def check_syntax_warning(testcase, statement, errtext='', *, lineno=1, offset=None): # Test also that a warning is emitted only once. from test.support import check_syntax_error with warnings.catch_warnings(record=True) as warns: warnings.simplefilter('always', SyntaxWarning) compile(statement, '<testcase>', 'exec') testcase.assertEqual(len(warns), 1, warns) warn, = warns testcase.assertTrue(issubclass(warn.category, SyntaxWarning), warn.category) if errtext: testcase.assertRegex(str(warn.message), errtext) testcase.assertEqual(warn.filename, '<testcase>') testcase.assertIsNotNone(warn.lineno) if lineno is not None: testcase.assertEqual(warn.lineno, lineno) # SyntaxWarning should be converted to SyntaxError when raised, # since the latter contains more information and provides better # error report. with warnings.catch_warnings(record=True) as warns: warnings.simplefilter('error', SyntaxWarning) check_syntax_error(testcase, statement, errtext, lineno=lineno, offset=offset) # No warnings are leaked when a SyntaxError is raised. testcase.assertEqual(warns, []) def ignore_warnings(*, category): """Decorator to suppress warnings. Use of context managers to hide warnings make diffs more noisy and tools like 'git blame' less useful. """ def decorator(test): @functools.wraps(test) def wrapper(self, *args, **kwargs): with warnings.catch_warnings(): warnings.simplefilter('ignore', category=category) return test(self, *args, **kwargs) return wrapper return decorator class WarningsRecorder(object): """Convenience wrapper for the warnings list returned on entry to the warnings.catch_warnings() context manager. """ def __init__(self, warnings_list): self._warnings = warnings_list self._last = 0 def __getattr__(self, attr): if len(self._warnings) > self._last: return getattr(self._warnings[-1], attr) elif attr in warnings.WarningMessage._WARNING_DETAILS: return None raise AttributeError("%r has no attribute %r" % (self, attr)) @property def warnings(self): return self._warnings[self._last:] def reset(self): self._last = len(self._warnings) @contextlib.contextmanager def check_warnings(*filters, **kwargs): """Context manager to silence warnings. Accept 2-tuples as positional arguments: ("message regexp", WarningCategory) Optional argument: - if 'quiet' is True, it does not fail if a filter catches nothing (default True without argument, default False if some filters are defined) Without argument, it defaults to: check_warnings(("", Warning), quiet=True) """ quiet = kwargs.get('quiet') if not filters: filters = (("", Warning),) # Preserve backward compatibility if quiet is None: quiet = True return _filterwarnings(filters, quiet) @contextlib.contextmanager def check_no_warnings(testcase, message='', category=Warning, force_gc=False): """Context manager to check that no warnings are emitted. This context manager enables a given warning within its scope and checks that no warnings are emitted even with that warning enabled. If force_gc is True, a garbage collection is attempted before checking for warnings. This may help to catch warnings emitted when objects are deleted, such as ResourceWarning. Other keyword arguments are passed to warnings.filterwarnings(). """ from test.support import gc_collect with warnings.catch_warnings(record=True) as warns: warnings.filterwarnings('always', message=message, category=category) yield if force_gc: gc_collect() testcase.assertEqual(warns, []) @contextlib.contextmanager def check_no_resource_warning(testcase): """Context manager to check that no ResourceWarning is emitted. Usage: with check_no_resource_warning(self): f = open(...) ... del f You must remove the object which may emit ResourceWarning before the end of the context manager. """ with check_no_warnings(testcase, category=ResourceWarning, force_gc=True): yield def _filterwarnings(filters, quiet=False): """Catch the warnings, then check if all the expected warnings have been raised and re-raise unexpected warnings. If 'quiet' is True, only re-raise the unexpected warnings. """ # Clear the warning registry of the calling module # in order to re-raise the warnings. frame = sys._getframe(2) registry = frame.f_globals.get('__warningregistry__') if registry: registry.clear() with warnings.catch_warnings(record=True) as w: # Set filter "always" to record all warnings. Because # test_warnings swap the module, we need to look up in # the sys.modules dictionary. sys.modules['warnings'].simplefilter("always") yield WarningsRecorder(w) # Filter the recorded warnings reraise = list(w) missing = [] for msg, cat in filters: seen = False for w in reraise[:]: warning = w.message # Filter out the matching messages if (re.match(msg, str(warning), re.I) and issubclass(warning.__class__, cat)): seen = True reraise.remove(w) if not seen and not quiet: # This filter caught nothing missing.append((msg, cat.__name__)) if reraise: raise AssertionError("unhandled warning %s" % reraise[0]) if missing: raise AssertionError("filter (%r, %s) did not catch any warning" % missing[0]) @contextlib.contextmanager def save_restore_warnings_filters(): old_filters = warnings.filters[:] try: yield finally: warnings.filters[:] = old_filters def _warn_about_deprecation(): warnings.warn( "This is used in test_support test to ensure" " support.ignore_deprecations_from() works as expected." " You should not be seeing this.", DeprecationWarning, stacklevel=0, ) PK ! �+�o o bytecode_helper.pynu �[��� """bytecode_helper - support tools for testing correct bytecode generation""" import unittest import dis import io _UNSPECIFIED = object() class BytecodeTestCase(unittest.TestCase): """Custom assertion methods for inspecting bytecode.""" def get_disassembly_as_string(self, co): s = io.StringIO() dis.dis(co, file=s) return s.getvalue() def assertInBytecode(self, x, opname, argval=_UNSPECIFIED): """Returns instr if opname is found, otherwise throws AssertionError""" for instr in dis.get_instructions(x): if instr.opname == opname: if argval is _UNSPECIFIED or instr.argval == argval: return instr disassembly = self.get_disassembly_as_string(x) if argval is _UNSPECIFIED: msg = '%s not found in bytecode:\n%s' % (opname, disassembly) else: msg = '(%s,%r) not found in bytecode:\n%s' msg = msg % (opname, argval, disassembly) self.fail(msg) def assertNotInBytecode(self, x, opname, argval=_UNSPECIFIED): """Throws AssertionError if opname is found""" for instr in dis.get_instructions(x): if instr.opname == opname: disassembly = self.get_disassembly_as_string(x) if argval is _UNSPECIFIED: msg = '%s occurs in bytecode:\n%s' % (opname, disassembly) self.fail(msg) elif instr.argval == argval: msg = '(%s,%r) occurs in bytecode:\n%s' msg = msg % (opname, argval, disassembly) self.fail(msg) PK ! m�oin n testresult.pynu �[��� PK ! %3z�� � � logging_helper.pynu �[��� PK ! �%�, �, � script_helper.pynu �[��� PK ! e�N�8 8 QH import_helper.pynu �[��� PK ! �^d��, �, �f socket_helper.pynu �[��� PK ! ��Ü% �% ) ۓ __pycache__/socket_helper.cpython-310.pycnu �[��� PK ! ~�YJ7 J7 % й __pycache__/os_helper.cpython-310.pycnu �[��� PK ! >Խ~ ~ & o� __pycache__/testresult.cpython-310.pycnu �[��� PK ! Z�mȖ � ) C __pycache__/import_helper.cpython-310.pycnu �[��� PK ! � � � , 2) __pycache__/threading_helper.cpython-310.pycnu �[��� PK ! �$���� �� $ AB __pycache__/__init__.cpython-310.pycnu �[��� PK ! j[ϩ| | ) v% __pycache__/script_helper.cpython-310.pycnu �[��� PK ! �� � ( KD __pycache__/interpreters.cpython-310.pycnu �[��� PK ! �u�(� � + c` __pycache__/warnings_helper.cpython-310.pycnu �[��� PK ! ;^��� � + �y __pycache__/bytecode_helper.cpython-310.pycnu �[��� PK ! ���jj j * �� __pycache__/hashlib_helper.cpython-310.pycnu �[��� PK ! 2 S� � * S� __pycache__/logging_helper.cpython-310.pycnu �[��� PK ! q��s s 9� hashlib_helper.pynu �[��� PK ! Q�o�� � � __init__.pynu �[��� PK ! E����M �M ߬ os_helper.pynu �[��� PK ! �0,� � � threading_helper.pynu �[��� PK ! �d��� � T interpreters.pynu �[��� PK ! ��H�� � X, warnings_helper.pynu �[��� PK ! �+�o o [F bytecode_helper.pynu �[��� PK � M
| ver. 1.1 | |
.
| PHP 8.4.18 | Ð“ÐµÐ½ÐµÑ€Ð°Ñ†Ð¸Ñ Ñтраницы: 0.04 |
proxy
|
phpinfo
|
ÐаÑтройка